v6ctl 0.1.2

The official CLI for the v6Node Reseller API.

v6ctl

The official CLI for the v6Node Reseller API.

Provision, manage, and script every reseller endpoint. Works interactively with Rich tables, or scripted with --json and proper exit codes.

$ v6ctl nodes list
╭────────────────────────────── Nodes ──────────────────────────────╮
│ ID        Hostname      Region     Plan      OS          IP      │
│ a0fd028d  prod-web-1    Frankfurt  Standard  debian-13   5.1.2.3 │
│ b12c444e  staging-db    Frankfurt  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.