{"slug":"cli-vps","title":"CLI: VPS Instances","description":"Manage VPS instances using the DanubeData CLI.","section":"CLI","url":"https://docs.danubedata.ro/cli-vps","markdown_url":"https://docs.danubedata.ro/cli-vps.md","breadcrumbs":[{"title":"CLI","slug":null},{"title":"VPS Instances","slug":"cli-vps"}],"headings":[{"level":1,"title":"CLI: VPS Instances","id":"cli-vps-instances"},{"level":2,"title":"Prerequisites","id":"prerequisites"},{"level":2,"title":"Quick start","id":"quick-start"},{"level":2,"title":"Listing instances","id":"listing-instances"},{"level":2,"title":"Creating a VPS","id":"creating-a-vps"},{"level":3,"title":"Interactive","id":"interactive"},{"level":3,"title":"With flags","id":"with-flags"},{"level":3,"title":"Available OS images","id":"available-os-images"},{"level":2,"title":"Viewing instance details","id":"viewing-instance-details"},{"level":2,"title":"Power management","id":"power-management"},{"level":3,"title":"Start","id":"start"},{"level":3,"title":"Stop","id":"stop"},{"level":3,"title":"Reboot","id":"reboot"},{"level":3,"title":"Check status","id":"check-status"},{"level":2,"title":"Updating a VPS","id":"updating-a-vps"},{"level":2,"title":"Reinstalling the OS","id":"reinstalling-the-os"},{"level":2,"title":"Monitoring","id":"monitoring"},{"level":2,"title":"SSH access","id":"ssh-access"},{"level":3,"title":"Retrieve SSH password","id":"retrieve-ssh-password"},{"level":3,"title":"Connect via SSH","id":"connect-via-ssh"},{"level":2,"title":"Deleting a VPS","id":"deleting-a-vps"},{"level":2,"title":"Complete workflow example","id":"complete-workflow-example"},{"level":2,"title":"Next steps","id":"next-steps"}],"format":"markdown","word_count":444,"content":"# CLI: VPS Instances\n\nManage VPS instances using the DanubeData CLI.\n\n## Prerequisites\n\n- [DanubeData CLI installed](https://docs.danubedata.ro/cli-overview)\n- Authenticated via `danube auth`, `danube login`, or `DANUBE_TOKEN`\n\n## Quick start\n\nList your instances:\n\n```bash\ndanube vps ls\n```\n\nCreate a new VPS interactively:\n\n```bash\ndanube vps create\n```\n\n## Listing instances\n\n```bash\ndanube vps ls\n```\n\nShows all VPS instances with ID, name, status, IP address, resource profile, and creation date.\n\n## Creating a VPS\n\n### Interactive\n\n```bash\ndanube vps create\n```\n\nThe CLI guides you through selecting an OS image, resource profile, and optional SSH key.\n\n### With flags\n\n```bash\ndanube vps create \\\n  --name my-server \\\n  --image ubuntu-24.04 \\\n  --plan nano_shared \\\n  --ssh-key-id <key-id>\n```\n\n### Available OS images\n\n```bash\ndanube vps images\n```\n\nLists all available operating system images with their identifiers.\n\n## Viewing instance details\n\n```bash\ndanube vps get <id>\n```\n\nDisplays full instance details including connection info, IP addresses, resource profile, and status.\n\n## Power management\n\n### Start\n\n```bash\ndanube vps start <id>\n```\n\nStarts a stopped VPS instance.\n\n### Stop\n\n```bash\ndanube vps stop <id>\n```\n\nGracefully stops a running VPS instance.\n\n### Reboot\n\n```bash\ndanube vps reboot <id>\n```\n\nReboots a running VPS instance.\n\n### Check status\n\n```bash\ndanube vps status <id>\n```\n\nShows the current status and available actions for an instance.\n\n## Updating a VPS\n\n```bash\ndanube vps update <id>\n```\n\nUpdate VPS configuration. The instance must be stopped before updating.\n\n## Reinstalling the OS\n\n```bash\ndanube vps reinstall <id>\n```\n\nReinstalls the operating system on an existing VPS. **This destroys all data on the instance.** The CLI prompts for confirmation before proceeding.\n\n## Monitoring\n\n```bash\ndanube vps metrics <id>\n```\n\nShows current resource usage:\n\n- CPU utilization\n- Memory usage\n- Storage usage\n- Network throughput\n\n## SSH access\n\n### Retrieve SSH password\n\n```bash\ndanube vps password <id>\n```\n\nDisplays the root SSH password. The CLI asks for confirmation before revealing it.\n\n### Connect via SSH\n\n```bash\nssh root@<public-ip>\n```\n\nUse the IP address shown in `danube vps get <id>` or `danube vps ls`.\n\n## Deleting a VPS\n\n```bash\ndanube vps delete <id>\n```\n\nPrompts for confirmation before deleting. This is irreversible — all data on the instance will be destroyed.\n\n## Complete workflow example\n\n```bash\n# Install the CLI\nnpm install -g @danubedata/cli\n\n# Authenticate\ndanube auth\n\n# List available OS images\ndanube vps images\n\n# Create a VPS\ndanube vps create \\\n  --name web-server \\\n  --image ubuntu-24.04 \\\n  --plan nano_shared\n\n# Check instance details\ndanube vps ls\n\n# View metrics\ndanube vps metrics <id>\n\n# Stop instance (note: still billed — delete to stop charges)\ndanube vps stop <id>\n\n# Start again\ndanube vps start <id>\n\n# Delete when no longer needed (stops billing)\ndanube vps delete <id>\n```\n\n## Next steps\n\n- [CLI Overview](https://docs.danubedata.ro/cli-overview) — Installation, auth, and configuration\n- [CLI: Object Storage](https://docs.danubedata.ro/cli-storage) — Manage storage buckets and access keys\n- [VPS overview](https://docs.danubedata.ro/vps-overview) — Full VPS product reference\n\n---\n\n**Questions?** Contact support at support@danubedata.ro\n","prev":{"title":"Overview","slug":"cli-overview","url":"https://docs.danubedata.ro/cli-overview","markdown_url":"https://docs.danubedata.ro/cli-overview.md","json_url":"https://docs.danubedata.ro/cli-overview.json"},"next":{"title":"Object Storage","slug":"cli-storage","url":"https://docs.danubedata.ro/cli-storage","markdown_url":"https://docs.danubedata.ro/cli-storage.md","json_url":"https://docs.danubedata.ro/cli-storage.json"},"index_url":"https://docs.danubedata.ro/index.json"}