How to Import / Export Servers

Bulk-register multiple servers at once using JSON or CSV, and export your server inventory for backups or migration.

Accessing Import / Export

On the Servers page, click the Import / Export dropdown button near the top-right. This reveals two options: Import and Export.

Exporting Servers

Exporting gives you a snapshot of your current server inventory. This is useful for backups, documentation, or migrating to another Pinguzo account.

Export as JSON

Click Export → JSON. The browser downloads a file named servers-export.json containing an array of server objects:

[
  {
    "name": "web-prod-01",
    "status": "online",
    "ip_address": "203.0.113.10",
    "hostname": "web-prod-01.example.com",
    "os": "Ubuntu 22.04 LTS",
    "last_seen": "2026-03-18T14:00:00Z",
    "created_at": "2026-01-05T09:30:00Z"
  },
  {
    "name": "db-primary",
    "status": "online",
    "ip_address": "203.0.113.20",
    "hostname": "db.internal",
    "os": "Rocky Linux 9",
    "last_seen": "2026-03-18T14:01:00Z",
    "created_at": "2026-01-05T10:00:00Z"
  }
]

Export as CSV

Click Export → CSV. The browser downloads servers-export.csv:

name,status,ip_address,hostname,os,last_seen,created_at
web-prod-01,online,203.0.113.10,web-prod-01.example.com,Ubuntu 22.04 LTS,2026-03-18T14:00:00Z,2026-01-05T09:30:00Z
db-primary,online,203.0.113.20,db.internal,Rocky Linux 9,2026-03-18T14:01:00Z,2026-01-05T10:00:00Z

Importing Servers

Importing lets you bulk-register server names (and optionally tags) without clicking through the form for each one. After import, each server gets a unique Agent Key, and you install the agent on each machine as usual.

Import via File Upload

1. Click Import / Export → Import
2. In the import modal, click Choose File and select a .json or .csv file from your computer
3. Click Import Servers to proceed

Import via Paste

Instead of uploading a file, you can paste JSON or CSV content directly into the textarea in the import modal. Pinguzo auto-detects the format.

Import File Formats

JSON Format

An array of objects. Only name is required:

[
  {"name": "app-server-01"},
  {"name": "app-server-02"},
  {"name": "cache-01", "tags": "production,cache"}
]

CSV Format

A header row followed by data rows. Only the name column is required:

name,tags
app-server-01,production
app-server-02,production
cache-01,"production,cache"

Supported Import Fields

Import Results

After a successful import, Pinguzo shows a summary:

• Imported: number of servers successfully created
• Skipped: number of entries skipped (duplicate names, validation failures)
• Errors: list of specific validation errors with the row number and reason

Each imported server is immediately assigned an Agent Key. Navigate to each server row, copy the key, and run the installation command on the corresponding machine.

Validation Rules

• name is required and must be 1–100 characters
• Server names must be unique per account — duplicates are skipped with an error
• Plan limits are enforced: if importing would exceed your plan's server limit, the import stops at the limit and reports how many were skipped
• Invalid rows (e.g., empty name, name too long) are skipped individually; valid rows are still imported

After Importing: Installing Agents

After import, each server record appears in the Servers list with a Pending status. To bring them online:

1. Click the terminal icon to see its Install Agent command
2. Copy the installation command
3. SSH into the corresponding machine and run the command as root
4. Repeat for each imported server

See Install Pinguzo Agent for the full agent installation guide.

Next Steps

• Install Pinguzo Agent — run the agent on each imported server
• Import / Export Monitors — bulk-create uptime monitors in the same way
• Configure Alerts — set up alert policies for the new servers