Hostodo CLI

The official CLI for managing Hostodo VPS instances. The binary is called odo.

🚀 Quick Start

Installation

Homebrew (macOS/Linux)

brew install hostodo/tap/odo

Download Binary

Download pre-built binaries from the releases page:

# macOS (Apple Silicon)
curl -L https://github.com/hostodo/odo-cli/releases/latest/download/odo-cli_Darwin_all.tar.gz | tar xz
sudo mv odo /usr/local/bin/

# Linux (amd64)
curl -L https://github.com/hostodo/odo-cli/releases/latest/download/odo-cli_Linux_x86_64.tar.gz | tar xz
sudo mv odo /usr/local/bin/

Package Managers

# Debian/Ubuntu
wget https://github.com/hostodo/odo-cli/releases/latest/download/odo_linux_amd64.deb
sudo dpkg -i odo_linux_amd64.deb

# RHEL/CentOS/Fedora
wget https://github.com/hostodo/odo-cli/releases/latest/download/odo_linux_amd64.rpm
sudo rpm -i odo_linux_amd64.rpm

From Source

Requires Go 1.25 or higher:

git clone https://github.com/hostodo/odo-cli.git
cd odo-cli
make install

Authentication

odo login

Uses OAuth device flow — a browser window opens for you to authorize the CLI. Your access token is stored in the OS keychain (macOS Keychain, Linux Secret Service). On headless systems without a keychain, a plain token file is stored at ~/.odo/token with 0600 permissions.

Basic Usage

# List all instances (interactive TUI)
odo list

# SSH into an instance
odo ssh <hostname>

# Deploy a new instance (interactive wizard)
odo deploy

# Deploy with a promo code
odo deploy --promo LETCLI

# Power control
odo start <hostname>
odo stop <hostname>
odo restart <hostname>

📖 Commands

Global Flags

• --api-url string - API URL (default: https://api.hostodo.com or $HOSTODO_API_URL, must be https://)
• --config string - Config file path (default: $HOME/.odo/config.json)
• -h, --help - Show help
• -v, --version - Show version

Authentication

odo login

Authenticate with your Hostodo account using OAuth device flow.

odo login

odo logout

Clear stored credentials.

odo logout

odo whoami

Show the currently authenticated user.

odo whoami

odo auth sessions

List active CLI sessions.

odo auth sessions

Instance Commands

All instance commands are under odo instances (alias: odo i). Flat shortcuts like odo ssh, odo list, odo start etc. also work.

Hostnames support exact match, unambiguous prefix match, and instance ID fallback. Tab completion works for hostnames.

odo instances / odo list

List all your VPS instances. Aliases: ls, ps.

Flags:

• --json - Output as JSON
• --simple - Output as simple ASCII table
• --details - Show detailed information
• --limit int - Max instances to fetch (default: 100)
• --offset int - Pagination offset

odo list
odo list --json
odo list --simple
odo list --details

Interactive TUI Controls:

• ↑/↓ or j/k — Navigate
• Enter — View instance details
• q / Esc / Ctrl+C — Quit

odo instances status <hostname>

Show detailed information about an instance.

odo instances status my-server
odo instances status my-server --json

odo instances start/stop/restart <hostname>

Power control.

odo start my-server
odo stop my-server
odo stop my-server --force   # immediate shutdown
odo restart my-server

odo instances ssh <hostname>

SSH into an instance. Auto-detects the SSH user from the template. Falls back to sshpass if key auth fails and the instance has a default password.

odo ssh my-server
odo ssh my-server --user ubuntu
odo ssh my-server -- -L 8080:localhost:8080   # extra ssh flags after --

odo instances rename <hostname> <new-hostname>

odo rename my-server new-name

odo instances reinstall <hostname>

Wipe and reinstall the OS on an instance. Destructive — all data will be lost.

# Interactive
odo reinstall my-server

# Specify OS
odo reinstall my-server --os "Debian 12"

# Specify OS + SSH key
odo reinstall my-server --os "Ubuntu 22.04" --ssh-key mykey

odo instances deploy

Deploy a new Hostodo VPS with interactive prompts or flags. Aliases: new, create.

Flags:

• --os string - OS template (skips OS prompt)
• --region string - Region: DET01, LV01, TPA01
• --plan string - Plan name (e.g. EPYC-2G1C32GN)
• --hostname string - Custom hostname
• --ssh-key string - SSH key name
• --billing-cycle string - monthly, annually, semiannually, biennially, triennially
• --promo string - Promo code for a discount
• -y, --yes - Skip confirmation
• --json - JSON output (requires --os, --region, --plan)

# Interactive wizard
odo deploy

# With promo code
odo deploy --promo LETCLI

# Fully non-interactive
odo deploy --os "Ubuntu 22.04" --region DET01 --plan EPYC-2G1C32GN --billing-cycle monthly --promo LETCLI --yes

# JSON output
odo deploy --os "Ubuntu 22.04" --region DET01 --plan EPYC-2G1C32GN --json

Billing

odo invoices

List invoices. Alias: bills.

odo invoices
odo invoices --status=unpaid

odo pay <invoice-id>

Pay an invoice using your default payment method.

odo pay INV-12345
odo pay INV-12345 --yes

SSH Keys

odo keys list
odo keys add mykey "ssh-rsa AAAA..."
odo keys add mykey --file ~/.ssh/id_rsa.pub
odo keys remove mykey

Shell Completions

Homebrew installs completions automatically. For manual installs:

# Zsh
odo completion zsh > "${fpath[1]}/_odo"

# Bash
odo completion bash > ~/.local/share/bash-completion/completions/odo

# Fish
odo completion fish > ~/.config/fish/completions/odo.fish

🔧 Configuration

Config is stored in ~/.odo/config.json:

{
  "api_url": "https://api.hostodo.com",
  "device_id": "a1b2c3d4-..."
}

Tokens are stored in the OS keychain. On systems without a keychain, a plain token file is used at ~/.odo/token with 0600 permissions. The config file never contains credentials.

Environment Variables

• HOSTODO_API_URL — Override the API URL (must be https://)

🏗️ Development

Building from Source

git clone https://github.com/hostodo/odo-cli.git
cd odo-cli
make build   # → ./odo
make test
make dev ARGS="instances list"

Project Structure

cmd/
├── root.go              # Root command, registers all subcommands
├── invoices.go          # Billing commands
├── pay.go
├── keys.go              # SSH key management
├── completion.go
├── auth/                # Auth subcommands (login, logout, whoami, sessions)
└── instances/           # Instance subcommands
    ├── root.go
    ├── list.go
    ├── status.go
    ├── start.go
    ├── stop.go
    ├── restart.go
    ├── ssh.go
    ├── rename.go
    ├── deploy.go        # Deployment wizard
    └── reinstall.go
pkg/
├── api/                 # HTTP client + endpoint methods + models
├── auth/                # Token storage (OS keychain + file fallback)
├── config/              # Config file (~/.odo/config.json)
├── resolver/            # Hostname resolution + tab completion
├── deploy/              # Hostname generation
├── ui/                  # Bubble Tea TUI, Lipgloss styles, output formatters
└── utils/               # SSH fingerprint utilities

📝 License

MIT — see LICENSE file for details.

🔗 Links

• Hostodo Website
• CLI Documentation
• Hostodo Console

💬 Support

• Email: support@hostodo.com
• Open an issue: github.com/hostodo/odo-cli/issues