v6ctl 0.1.0

Command-line interface for the v6Node cloud platform.

v6ctl

The official command-line interface for the v6Node cloud platform.

Deploy and manage VPS nodes, SSH keys, webhooks, and more — all from your terminal.

$ v6ctl nodes list
╭───────────────────────────── Nodes ─────────────────────────────╮
│ ID        Hostname      Region    Plan      OS          IP     │
│ a0fd028d  prod-web-1    Nürnberg  Standard  debian-13   5.1.2.3 │
│ b12c444e  staging-db    Nürnberg  Compute   ubuntu-24   5.1.2.4 │
╰─────────────────────────────────────────────────────────────────╯

Install

pipx install v6ctl

Don't have pipx?

# macOS
brew install pipx

# Debian / Ubuntu
sudo apt install pipx

# Everywhere else
python3 -m pip install --user pipx
python3 -m pipx ensurepath

Or use plain pip:

pip install v6ctl

Configure

Get your API token from the v6Node dashboard, then:

v6ctl config set token v6_...

Token is stored at ~/.config/v6ctl/config.json with 0600 permissions.

Alternatively, set V6_TOKEN in your environment.

Use

v6ctl nodes list                                # list your nodes
v6ctl nodes show <pay-id>                       # full details for a node
v6ctl nodes create -r 7 -p 13 -k 3200 -t debian-13
v6ctl nodes reboot <pay-id>
v6ctl nodes delete <pay-id>

v6ctl keys list                                 # list SSH keys
v6ctl keys create -d "laptop" -k "ssh-ed25519 AAAA..."

v6ctl webhooks create -u https://example.com/hook -e node.deployed

v6ctl plans                                     # available plans + pricing
v6ctl regions                                   # available regions
v6ctl templates                                 # available OS templates

Run v6ctl --help or v6ctl <command> --help for the full reference.

JSON output

Every command supports --json for scripting:

v6ctl --json nodes list | jq '.items[].pay_id'
v6ctl --json plans       | jq '.[] | select(.memory_mb >= 4096)'

Configuration

Where	Precedence
--flag on the command line	1 (highest)
Environment variable (V6_TOKEN, V6_API_URL)	2
Config file ~/.config/v6ctl/config.json	3
Built-in defaults	4 (lowest)

v6ctl config show            # show resolved config (token redacted)
v6ctl config path            # print config file path
v6ctl config set api_url https://cloud.v6node.com/api/v1
v6ctl config unset token

Requirements

• Python 3.10 or newer

License

MIT — see LICENSE.