twc-rs
A fast, single-binary CLI and interactive TUI dashboard for Timeweb Cloud.
Servers, databases, S3, Kubernetes, balancers, domains, firewalls, apps and
more — managed from one native binary. No Python, no pip, no virtualenv.

Highlights
| Cold start | ~2 ms (the official Python CLI needs ~350 ms) |
| Footprint | one static 15 MB binary, no runtime dependencies |
| Dashboard | live k9s-style TUI with per-resource metrics |
| Coverage | near-full parity with the official CLI |
| Completions | bash, zsh, fish, powershell, elvish, nushell — plus dynamic live-value completion |
| Languages | English and Russian, CLI and TUI |
The CLI reference section of this book is generated directly from the command definitions on every deploy, so it always matches the released code.
Installation
Every channel ships with the TUI dashboard enabled by default.
| Channel | Command |
|---|---|
| crates.io | cargo install twc-rs |
| Installer (Linux/macOS) | curl -fsSL https://raw.githubusercontent.com/RAprogramm/twc-rs/main/install.sh | sh |
| Arch (AUR) | paru -S twc-rs-bin |
| Debian/Ubuntu | sudo apt install ./twc-rs_<ver>_amd64.deb |
| Releases | download from GitHub Releases, verify the .sha256 |
For a lean, headless CLI without the TUI:
cargo install twc-rs --no-default-features --features auth
Supported platforms
| OS | Architectures |
|---|---|
| Linux (glibc) | x86_64, aarch64 |
| macOS | x86_64, aarch64 (Apple Silicon) |
| Windows | x86_64 |
Run twc-rs doctor after installing to detect conflicting copies in PATH.
Authentication
twc-rs auth flow # guided browser flow, stored in the OS keyring
# or
twc-rs config set-token --token <TOKEN>
The token is resolved in this order:
--tokenflagTWC_TOKENenvironment variable- OS keyring
- config file (
~/.config/twc-rs/config.toml)
Profiles
Multiple accounts are supported via named profiles:
twc-rs config set-token --profile staging --token <TOKEN>
twc-rs --profile staging server list
The active profile can also be switched from inside the dashboard.
Usage
Every resource type is a subcommand; run twc-rs <group> --help to see its
actions and flags — the help screens are colorized.

twc-rs server list # list cloud servers
twc-rs server info --id 12345 # server details
twc-rs database list -f json # JSON output
twc-rs ssh attach --server 12345 --key 42 # attach an SSH key to a server
twc-rs project resources --id 678 # drill into a project
twc-rs apps logs my-api --today # app runtime logs by name or ID
twc-rs apps list-deploys my-api # deploy history, newest first
twc-rs doctor # detect conflicting installs in PATH
twc-rs dashboard # interactive TUI (k9s-style)
Per-app commands accept either the app name or its numeric ID.
Global flags
| Flag | Env | Meaning |
|---|---|---|
-f, --format <table|json|yaml|quiet> | TWC_OUTPUT | output format (default table) |
-t, --token <TOKEN> | TWC_TOKEN | API token override |
--profile <NAME> | TWC_PROFILE | named profile for multi-account setups |
The full, always-current list of commands is in the CLI reference.
Dashboard (TUI)
The headline feature the official Python CLI does not have: a live, k9s-style TUI.
twc-rs dashboard

Keys
| Key | Action |
|---|---|
h / l | switch resource tabs |
j / k | move selection |
Enter | open the action menu / drill into a resource |
n | create a new resource (where supported) |
/ | filter the current list |
Ctrl+K | command palette — actions, theme, language, profile switch |
? | help overlay |
Q | quit |
Features
- Context action menu per resource (reboot / shutdown / clone / delete) with a confirmation step for destructive actions.
- Create resources and switch the account profile without leaving the dashboard.
- Live per-resource metrics (CPU / RAM / network sparklines) fetched off the UI thread, so input never blocks on the network.
- Drill into a project to see its resources; live event log.
- Customizable layout, hide-empty-tabs, four true-color themes and EN/RU — all persisted to the config file.
Shell completions
Static scripts
twc-rs completions nushell > ~/.config/nushell/completions/twc-rs.nu
twc-rs completions zsh > ~/.zfunc/_twc-rs
twc-rs completions bash > /etc/bash_completion.d/twc-rs
Supported shells: bash, zsh, fish, powershell, elvish, nushell.
The AUR package installs completions into the standard vendor directories.
Dynamic completions
The dynamic engine also completes live values — twc-rs apps logs <TAB>
offers your actual apps by name and ID, fetched from the API (silently
skipped when offline).

| Shell | Add to |
|---|---|
| bash | echo 'source <(COMPLETE=bash twc-rs)' >> ~/.bashrc |
| zsh | echo 'source <(COMPLETE=zsh twc-rs)' >> ~/.zshrc |
| fish | echo 'COMPLETE=fish twc-rs | source' >> ~/.config/fish/config.fish |
| elvish | echo 'eval (E:COMPLETE=elvish twc-rs | slurp)' >> ~/.elvish/rc.elv |
| powershell | $env:COMPLETE = "powershell"; twc-rs | Out-String | Invoke-Expression; Remove-Item Env:\COMPLETE in $PROFILE |
Nushell keeps the static script — the dynamic engine does not support it yet.
twc-rs vs the official Timeweb CLI — measured comparison
A head-to-head against the official Python CLI
timeweb-cloud/twc. Every performance
number below is produced live by benches/compare.sh
— nothing here is hand-written or estimated. Re-run it yourself to reproduce.
Test environment
| CPU | AMD Ryzen AI MAX+ 395 (32 threads) |
| Memory | 62 GiB |
| OS / kernel | Linux 7.1.2 (x86_64) |
| Rust toolchain | rustc 1.96.0 (release build, --features tui, stripped) |
| Official CLI | twc-cli v2.15.2, in a clean virtualenv on Python 3.14.6 |
| Sampling | 50 runs per measurement, mean reported, one warm-up discarded |
| Startup metric | --version / --help (no network — pure process start) |
| Memory metric | peak RSS via getrusage(RUSAGE_CHILDREN) |
Reproduce:
cargo build --release --features tui
python3 -m venv /tmp/twcbench && /tmp/twcbench/bin/pip install twc-cli
benches/compare.sh ./target/release/twc-rs /tmp/twcbench/bin/twc
Performance — twc-rs wins on every axis
| Metric | twc-rs | official twc | Advantage |
|---|---|---|---|
Cold start (--version) | 2.3 ms | 357.3 ms | ≈155× faster |
Cold start (--help) | 2.1 ms | 347.4 ms | ≈165× faster |
| Peak memory (RSS) | 13.7 MB | 59.2 MB | ≈4.3× less |
| On-disk size | 15 MB, one static binary | 33 MB of packages + a Python interpreter | smaller, self-contained |
| Runtime dependencies | system libc only | 15 PyPI packages + CPython | none to install |
| Install | copy one file | pip + Python toolchain | no runtime needed |
The Python tool spends ~350 ms loading the interpreter and importing its
dependency tree before any application code runs; twc-rs is a native binary,
so the same invocation completes in single-digit milliseconds.
Capabilities only twc-rs has
| Feature | twc-rs | official |
|---|---|---|
| Interactive TUI dashboard (k9s-style) | yes | no |
| Live per-resource metrics (CPU / RAM / network) | yes | no |
| Create / delete resources from the dashboard | yes | no |
| Switch account profile from the dashboard | yes | no |
| Localization — English + Russian (CLI & TUI) | yes | English only |
Named profiles (--profile) | yes | yes |
Installation self-check (doctor finds conflicting copies in PATH) | yes | no |
| Address apps by name, not just numeric ID | yes | no |
| Dynamic shell completion of live resource values (app names/IDs from the API) | yes | no |
| Shell completions | bash, zsh, fish, powershell, elvish, nushell | bash, zsh, fish, powershell |
Command coverage
Near-complete parity with the official CLI across all resource groups
(accounting for naming: ssh-key≈ssh, storage≈s3, cluster≈kubernetes,
balancer backend≈balancer ip-*):
| Group | Status |
|---|---|
| account | full — status, finances (show), access restrictions |
| apps | full — list, info, create, delete, presets, repositories, vcs-providers, logs (--tail/--since/--today), list-deploys, deploy-logs; per-app commands accept the app name or ID |
| balancer | full — list/info/create/update/delete, rules, IPs (backends), presets |
| database | full — list/info/create/update/delete, backups, users, presets, types, instances |
| domain | full — list/info/add/delete, DNS records, subdomains, name servers |
| firewall | full — groups, rules, resource link/unlink |
| image | full — list, info, create, set, delete, upload |
| ip | full — list, info, create, attach, detach, set, delete |
| kubernetes | full — clusters, node groups, nodes, addons, presets, versions, network drivers |
| project | full — list, create, set, delete, resources |
| server | list, info, create, set, clone, delete, reboot, start, shutdown, reset-password, resize, reinstall, disk, ip, history, backup-list, backup-create, set-nat-mode, set-boot-mode, list-presets/os/software/configurators |
| ssh-key | full — list, add (upload), info, edit, delete, attach/detach key to a server |
| storage (s3) | full — buckets, users, subdomains, transfer, presets, genconfig |
| vpc | full — list, info, create, set, delete, ports |
The single uncovered command is server vnc — Timeweb’s API has no VNC
endpoint at all (it is absent from the OpenAPI spec), so there is nothing to
call. image upload was missing only because the upstream spec omitted the
request body; that defect was fixed in the timeweb-rs
normalizer (0.3.0) and the command now works. Custom server configurators
(CPU/RAM/disk arrays) remain behind the common preset path. The TUI dashboard
additionally exposes delete / power / clone management for every integer-id
resource.
Engineering quality
| Lints | clean under clippy pedantic + nursery, no #[allow] crutches |
| Tasks | non-blocking UI — data fetched off the render thread |
| SDK | generated from the official OpenAPI spec via timeweb-rs; spec defects fixed in a normalizer pass, never by hand-editing generated code |
| Deprecations | zero — migrated to the current v2/cluster endpoints |
CLI reference
Generated from the clap command definitions by cargo run --bin docgen; do not edit by hand.
| Command | Description |
|---|---|
server | Manage cloud servers |
ssh | Manage SSH keys |
project | Manage projects |
database | Manage databases |
s3 | Manage S3 storages |
kubernetes | Manage Kubernetes clusters |
registry | Manage container registries |
balancer | Manage load balancers |
domain | Manage domains |
firewall | Manage firewall groups |
apps | Manage cloud apps |
image | Manage disk images |
ip | Manage floating IPs |
vpc | Manage virtual networks (VPC) |
account | Show account information |
config | Configure twc-rs settings |
auth | Authenticate with Timeweb Cloud (guided browser flow) |
dashboard | Open the interactive dashboard |
completions | Generate a shell completion script (print to stdout) |
doctor | Check the local installation for conflicting copies in PATH |
update | Check for a newer release and update via the detected install channel |
twc-rs server
Manage cloud servers
| Subcommand | Description |
|---|---|
list | List all cloud servers |
info | Show detailed info for a server |
delete | Delete a server by ID |
reboot | Reboot a server by ID |
start | Power a server on |
shutdown | Gracefully shut a server down |
clone | Clone a server by ID |
reset-password | Reset a server’s root password |
list-presets | List available server presets |
list-os | List installable OS images |
list-software | List available pre-installable software |
list-configurators | List server configurators (custom builds) |
disk | List the disks attached to a server |
ip | List the IP addresses of a server |
history | Show the recent action history (logs) of a server |
set-nat-mode | Set the NAT mode of a server’s local network |
set-boot-mode | Set the OS boot mode of a server (restarts the server) |
resize | Resize a server to a different preset |
reinstall | Reinstall the OS of a server (wipes data) |
create | Create a new cloud server from a preset and OS image |
set | Update a server’s name and/or comment |
backup-list | List disk backups of a server |
backup-create | Create a disk backup of a server’s system disk |
twc-rs server list
List all cloud servers
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of servers to return | |||
--offset | Number of servers to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server info
Show detailed info for a server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server delete
Delete a server by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server reboot
Reboot a server by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server start
Power a server on
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server shutdown
Gracefully shut a server down
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server clone
Clone a server by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server reset-password
Reset a server’s root password
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server list-presets
List available server presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server list-os
List installable OS images
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server list-software
List available pre-installable software
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server list-configurators
List server configurators (custom builds)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server disk
List the disks attached to a server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server ip
List the IP addresses of a server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server history
Show the recent action history (logs) of a server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server set-nat-mode
Set the NAT mode of a server’s local network
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--nat-mode | One of: dnat_and_snat, snat, no_nat | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server set-boot-mode
Set the OS boot mode of a server (restarts the server)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--boot-mode | One of: default, single, recovery_disk | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server resize
Resize a server to a different preset
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--preset-id | Target preset ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server reinstall
Reinstall the OS of a server (wipes data)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--os-id | OS image ID to install | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server create
Create a new cloud server from a preset and OS image
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Server name (max 255 chars) | yes | ||
--preset-id | Preset (tariff) ID. Use server list-presets to list | yes | ||
--os-id | OS image ID. Use server list-os to list | yes | ||
--comment | Optional comment (max 255 chars) | |||
--ssh-key | SSH key IDs to attach (repeatable) | |||
--project-id | Project ID to place the server in | |||
--availability-zone | Availability zone (e.g. spb-1, msk-1, ams-1) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server set
Update a server’s name and/or comment
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--name | New name | |||
--comment | New comment | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server backup-list
List disk backups of a server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs server backup-create
Create a disk backup of a server’s system disk
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Server ID | yes | ||
--comment | Optional backup comment | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh
Manage SSH keys
| Subcommand | Description |
|---|---|
list | List all SSH keys |
add | Add an SSH key from a file or stdin |
delete | Delete an SSH key by ID |
info | Show detailed information about an SSH key |
edit | Edit an SSH key’s name and/or default flag |
attach | Attach existing SSH key(s) to a cloud server |
detach | Detach an SSH key from a cloud server |
twc-rs ssh list
List all SSH keys
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh add
Add an SSH key from a file or stdin
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Human-readable name for the key | yes | ||
--file | Path to the public key file. Reads from stdin if omitted | |||
--default | Mark this key as default for new servers | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh delete
Delete an SSH key by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | SSH key ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh info
Show detailed information about an SSH key
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | SSH key ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh edit
Edit an SSH key’s name and/or default flag
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | SSH key ID | yes | ||
--name | New name for the key | |||
--default | Mark this key as default for new servers | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh attach
Attach existing SSH key(s) to a cloud server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--server | Target server ID | yes | ||
--key | SSH key ID to attach. Repeat to attach several at once | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ssh detach
Detach an SSH key from a cloud server
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--server | Target server ID | yes | ||
--key | SSH key ID to detach | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs project
Manage projects
| Subcommand | Description |
|---|---|
list | List all projects |
create | Create a new project |
delete | Delete a project by ID |
set | Update a project’s name and/or description |
resources | List all resources in a project |
twc-rs project list
List all projects
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs project create
Create a new project
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Project name (max 255 chars) | yes | ||
--description | Project description (max 255 chars) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs project delete
Delete a project by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Project ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs project set
Update a project’s name and/or description
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Project ID | yes | ||
--name | New project name (max 255 chars) | |||
--description | New project description (max 255 chars) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs project resources
List all resources in a project
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Project ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database
Manage databases
| Subcommand | Description |
|---|---|
list | List all databases |
info | Show detailed info for a database |
create | Create a new database |
delete | Delete a database by ID |
update | Update database settings |
backup-list | List backups for a database |
backup-create | Create a backup for a database |
user-list | List users for a database |
user-create | Create a user for a database |
user-delete | Delete a user from a database |
preset-list | List available database presets |
list-types | List available database cluster types (engines and versions) |
list-instances | List individual database instances within a cluster |
twc-rs database list
List all databases
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of databases to return | |||
--offset | Number of databases to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database info
Show detailed info for a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database create
Create a new database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Database name | yes | ||
--type | Database engine type (mysql, postgres, redis, mongodb, opensearch, clickhouse, kafka, rabbitmq) | yes | ||
-p, --preset-id | Preset ID for the database | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database delete
Delete a database by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database update
Update database settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
--name | New database name | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database backup-list
List backups for a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database backup-create
Create a backup for a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database user-list
List users for a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database user-create
Create a user for a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--db-id | Database ID | yes | ||
--login | Database user login name | yes | ||
--password | Database user password | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database user-delete
Delete a user from a database
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--db-id | Database ID | yes | ||
--user-name | Database user login name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database preset-list
List available database presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database list-types
List available database cluster types (engines and versions)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs database list-instances
List individual database instances within a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Database cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3
Manage S3 storages
| Subcommand | Description |
|---|---|
list | List all S3 storages |
info | Show detailed info for a storage |
create | Create a new S3 storage |
delete | Delete a storage by ID |
update | Update storage settings |
user-list | List users for a storage |
user-update | Update a storage user |
transfer | Transfer a storage |
subdomain-list | List subdomains for a storage |
subdomain-add | Add a subdomain to a storage |
subdomain-delete | Delete a subdomain from a storage |
preset-list | List available storage presets |
genconfig | Print an s3cmd config file for a storage |
twc-rs s3 list
List all S3 storages
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of storages to return | |||
--offset | Number of storages to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 info
Show detailed info for a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 create
Create a new S3 storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Storage name | yes | ||
-p, --preset-id | Preset ID for the storage | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 delete
Delete a storage by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 update
Update storage settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
--description | New storage description | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 user-list
List users for a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 user-update
Update a storage user
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--user-id | Storage user ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 transfer
Transfer a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--target-id | Target storage ID (reserved for future use) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 subdomain-list
List subdomains for a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 subdomain-add
Add a subdomain to a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
--subdomain | Subdomain name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 subdomain-delete
Delete a subdomain from a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
--subdomain | Subdomain name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 preset-list
List available storage presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs s3 genconfig
Print an s3cmd config file for a storage
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Storage ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes
Manage Kubernetes clusters
| Subcommand | Description |
|---|---|
list | List all Kubernetes clusters |
info | Show detailed info for a cluster |
create | Create a new Kubernetes cluster |
delete | Delete a cluster by ID |
update | Update cluster settings |
nodegroup-list | List node groups for a cluster |
nodegroup-create | Create a node group for a cluster |
nodegroup-delete | Delete a node group from a cluster |
node-list | List nodes for a cluster |
addon-list | List installed addons for a cluster |
addon-install | Install an addon on a cluster |
addon-delete | Delete an addon from a cluster |
preset-list | List available Kubernetes presets |
version-list | List available Kubernetes versions |
network-drivers | List available Kubernetes network drivers |
kubeconfig | Get kubeconfig for a cluster |
resources | Show cluster resources (deprecated) |
twc-rs kubernetes list
List all Kubernetes clusters
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of clusters to return | |||
--offset | Number of clusters to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes info
Show detailed info for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes create
Create a new Kubernetes cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Cluster name | yes | ||
--type | Kubernetes version (e.g., 1.30) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes delete
Delete a cluster by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes update
Update cluster settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
--name | New cluster name | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes nodegroup-list
List node groups for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes nodegroup-create
Create a node group for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
--name | Node group name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes nodegroup-delete
Delete a node group from a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
--group-id | Node group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes node-list
List nodes for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes addon-list
List installed addons for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes addon-install
Install an addon on a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
--addon-name | Addon name (e.g., calico, metrics-server) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes addon-delete
Delete an addon from a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
--addon-name | Addon name to delete | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes preset-list
List available Kubernetes presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes version-list
List available Kubernetes versions
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes network-drivers
List available Kubernetes network drivers
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes kubeconfig
Get kubeconfig for a cluster
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs kubernetes resources
Show cluster resources (deprecated)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Cluster ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry
Manage container registries
| Subcommand | Description |
|---|---|
list | List all container registries |
info | Show detailed info for a registry |
create | Create a new container registry |
delete | Delete a registry by ID |
update | Update registry settings |
repo-list | List repositories for a registry |
preset-list | List available registry presets |
twc-rs registry list
List all container registries
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of registries to return (not supported by API) | |||
--offset | Number of registries to skip (not supported by API) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry info
Show detailed info for a registry
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Registry ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry create
Create a new container registry
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Registry name (3-48 chars, lowercase alphanumeric and hyphens) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry delete
Delete a registry by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Registry ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry update
Update registry settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Registry ID | yes | ||
--description | New registry description | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry repo-list
List repositories for a registry
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Registry ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs registry preset-list
List available registry presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer
Manage load balancers
| Subcommand | Description |
|---|---|
list | List all balancers |
info | Show detailed info for a balancer |
create | Create a new balancer |
delete | Delete a balancer by ID |
update | Update balancer settings |
rule-list | List rules for a balancer |
rule-create | Create a rule for a balancer |
rule-delete | Delete a rule from a balancer |
ip-list | List IPs for a balancer |
ip-add | Add an IP to a balancer |
ip-remove | Remove an IP from a balancer |
preset-list | List available balancer presets |
twc-rs balancer list
List all balancers
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of balancers to return | |||
--offset | Number of balancers to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer info
Show detailed info for a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer create
Create a new balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Balancer name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer delete
Delete a balancer by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer update
Update balancer settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
--name | New balancer name | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer rule-list
List rules for a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer rule-create
Create a rule for a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer rule-delete
Delete a rule from a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
--rule-id | Rule ID to delete | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer ip-list
List IPs for a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer ip-add
Add an IP to a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
--ip | IP address to add | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer ip-remove
Remove an IP from a balancer
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Balancer ID | yes | ||
--ip | IP address to remove | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs balancer preset-list
List available balancer presets
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain
Manage domains
| Subcommand | Description |
|---|---|
list | List all domains on the account |
info | Show detailed info for a domain |
check | Check if a domain is available for registration |
add | Add a domain to the account |
delete | Delete a domain from the account |
dns-list | List DNS records for a domain |
dns-add | Add a DNS record to a domain |
dns-delete | Delete a DNS record from a domain |
dns-update | Update a DNS record on a domain |
ns-list | List name servers for a domain |
ns-update | Update name servers for a domain |
subdomain-list | List subdomains for a domain |
subdomain-add | Add a subdomain to a domain |
subdomain-delete | Delete a subdomain from a domain |
request-list | List domain registration/transfer/prolongation requests |
tld-list | List available TLDs (top-level domains) |
auto-prolong | Toggle auto-prolongation for a domain |
twc-rs domain list
List all domains on the account
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of domains to return | |||
--offset | Number of domains to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain info
Show detailed info for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain check
Check if a domain is available for registration
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--domain | Domain name to check (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain add
Add a domain to the account
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--domain | Domain FQDN to add (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain delete
Delete a domain from the account
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN to delete (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain dns-list
List DNS records for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain dns-add
Add a DNS record to a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--record-type | DNS record type (A, AAAA, CNAME, MX, TXT, SRV) | yes | ||
--value | DNS record value (e.g., IP address for A record) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain dns-delete
Delete a DNS record from a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--record-id | DNS record ID to delete | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain dns-update
Update a DNS record on a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--record-id | DNS record ID to update | yes | ||
--record-type | New DNS record type (A, AAAA, CNAME, MX, TXT, SRV) | yes | ||
--value | New DNS record value | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain ns-list
List name servers for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain ns-update
Update name servers for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
-1, --ns1 | First name server (e.g., ns1.example.com) | yes | ||
-2, --ns2 | Second name server (e.g., ns2.example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain subdomain-list
List subdomains for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain subdomain-add
Add a subdomain to a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--name | Subdomain name (e.g., www) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain subdomain-delete
Delete a subdomain from a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--name | Subdomain name to delete (e.g., www) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain request-list
List domain registration/transfer/prolongation requests
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain tld-list
List available TLDs (top-level domains)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs domain auto-prolong
Toggle auto-prolongation for a domain
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Domain FQDN (e.g., example.com) | yes | ||
--enabled | Enable (true) or disable (false) auto-prolongation | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall
Manage firewall groups
| Subcommand | Description |
|---|---|
list | List all firewall groups |
info | Show detailed info for a firewall group |
create | Create a new firewall group |
delete | Delete a firewall group by ID |
update | Update firewall group settings |
rule-list | List rules for a firewall group |
rule-create | Create a rule for a firewall group |
rule-delete | Delete a rule from a firewall group |
resource-list | List resources for a firewall group |
resource-add | Add a resource to a firewall group |
resource-remove | Remove a resource from a firewall group |
twc-rs firewall list
List all firewall groups
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--limit | Maximum number of groups to return | |||
--offset | Number of groups to skip | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall info
Show detailed info for a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall create
Create a new firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Group name | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall delete
Delete a firewall group by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall update
Update firewall group settings
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
--name | New group name | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall rule-list
List rules for a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall rule-create
Create a rule for a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall rule-delete
Delete a rule from a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
--rule-id | Rule ID to delete | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall resource-list
List resources for a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall resource-add
Add a resource to a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
--resource-id | Resource ID to add | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs firewall resource-remove
Remove a resource from a firewall group
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Firewall group ID | yes | ||
--resource-id | Resource ID to remove | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps
Manage cloud apps
| Subcommand | Description |
|---|---|
list | List all cloud apps |
info | Show detailed info for a single app |
delete | Delete an app |
list-presets | List available app presets (tariffs) |
list-vcs-providers | List configured VCS providers |
list-repositories | List repositories of a VCS provider |
create | Create a new app from a connected VCS repository |
logs | Show runtime logs of an app |
list-deploys | List deploys of an app, newest first |
deploy-logs | Show build/deploy logs of a deploy (the latest one by default) |
twc-rs apps list
List all cloud apps
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps info
Show detailed info for a single app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps delete
Delete an app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-presets
List available app presets (tariffs)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-vcs-providers
List configured VCS providers
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-repositories
List repositories of a VCS provider
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--provider-id | VCS provider ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps create
Create a new app from a connected VCS repository
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | App name | yes | ||
--comment | Optional comment | |||
--provider-id | VCS provider ID (UUID) | yes | ||
--repository-id | Repository ID (UUID) | yes | ||
--preset-id | Preset (tariff) ID | yes | ||
--type | App type: backend or frontend | yes | ||
--framework | Framework (e.g. docker, react, next.js, django) | yes | ||
--branch | Repository branch to build from | main | ||
--commit-sha | Specific commit SHA (defaults to latest on the branch) | |||
--build-cmd | Build command | |||
--run-cmd | Run command (required for backend apps) | |||
--index-dir | Index directory starting with ‘/’ (required for frontend apps) | |||
--auto-deploy | Enable automatic deploy on push | false | ||
--project-id | Optional project ID to place the app in | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps logs
Show runtime logs of an app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
--tail | Show only the last N lines (applied after date filters) | |||
--since | Show only lines logged at or after this moment; accepts YYYY-MM-DD (local midnight) or an RFC 3339 timestamp | |||
--today | Show only lines logged today (local time) | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-deploys
List deploys of an app, newest first
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps deploy-logs
Show build/deploy logs of a deploy (the latest one by default)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
--deploy-id | Deploy ID (UUID); defaults to the most recent deploy | |||
--debug | Include debug output | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image
Manage disk images
| Subcommand | Description |
|---|---|
list | List all disk images |
info | Show detailed info for an image |
create | Create a new image |
set | Update an image’s name |
delete | Delete an image by ID |
upload | Upload a local image file to an image |
twc-rs image list
List all disk images
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image info
Show detailed info for an image
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Image ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image create
Create a new image
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | Image name | yes | ||
--location | Location where the image is created | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image set
Update an image’s name
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Image ID | yes | ||
--name | New image name | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image delete
Delete an image by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Image ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs image upload
Upload a local image file to an image
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Image ID | yes | ||
--file | Path to the local image file | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip
Manage floating IPs
| Subcommand | Description |
|---|---|
list | List all floating IPs |
info | Show detailed info about a floating IP |
create | Create a new floating IP in an availability zone |
attach | Attach a floating IP to a resource |
detach | Detach a floating IP from its resource |
set | Update a floating IP’s comment |
delete | Delete a floating IP by ID |
twc-rs ip list
List all floating IPs
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip info
Show detailed info about a floating IP
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Floating IP ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip create
Create a new floating IP in an availability zone
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--availability-zone | Availability zone (e.g. spb-1, msk-1, ams-1) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip attach
Attach a floating IP to a resource
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Floating IP ID | yes | ||
--resource-id | Resource ID to bind to | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip detach
Detach a floating IP from its resource
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Floating IP ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip set
Update a floating IP’s comment
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Floating IP ID | yes | ||
--comment | New comment | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs ip delete
Delete a floating IP by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | Floating IP ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc
Manage virtual networks (VPC)
| Subcommand | Description |
|---|---|
list | List all virtual networks |
info | Show detailed information about a VPC |
create | Create a new VPC |
set | Update a VPC’s name and/or description |
ports | List network ports of a VPC |
delete | Delete a VPC by ID |
twc-rs vpc list
List all virtual networks
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc info
Show detailed information about a VPC
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | VPC ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc create
Create a new VPC
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | VPC name | yes | ||
--subnet-v4 | IPv4 subnet mask (e.g. 192.168.0.0/24) | yes | ||
--location | Location (e.g. ru-1) | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc set
Update a VPC’s name and/or description
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | VPC ID | yes | ||
--name | New name | |||
--description | New description | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc ports
List network ports of a VPC
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | VPC ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs vpc delete
Delete a VPC by ID
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--id | VPC ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs account
Show account information
| Subcommand | Description |
|---|---|
show | Show account login, company and balance |
access | Show account auth access restrictions (IP/country allow lists) |
twc-rs account show
Show account login, company and balance
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs account access
Show account auth access restrictions (IP/country allow lists)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs config
Configure twc-rs settings
| Subcommand | Description |
|---|---|
show | Show the current configuration |
set-token | Set the API token (for the default profile, or a named one) |
profiles | List configured profile names |
set-language | Set the UI language (en or ru) |
twc-rs config show
Show the current configuration
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs config set-token
Set the API token (for the default profile, or a named one)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--token | The Timeweb Cloud API token | yes | ||
--profile | Store the token under this profile name instead of the default | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table |
twc-rs config profiles
List configured profile names
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs config set-language
Set the UI language (en or ru)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<LANGUAGE> | Language code | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs auth
Authenticate with Timeweb Cloud (guided browser flow)
| Subcommand | Description |
|---|---|
flow | Run the guided browser authentication flow |
status | Show current authentication status |
logout | Remove stored token from keyring and config |
token | Accept a token directly (for CI/CD) |
twc-rs auth flow
Run the guided browser authentication flow
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs auth status
Show current authentication status
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs auth logout
Remove stored token from keyring and config
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs auth token
Accept a token directly (for CI/CD)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--token | The API token to store | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs dashboard
Open the interactive dashboard
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-i, --interval | Refresh interval in seconds | 5 | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs completions
Generate a shell completion script (print to stdout)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<SHELL> | Target shell | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs doctor
Check the local installation for conflicting copies in PATH
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs update
Check for a newer release and update via the detected install channel
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--check | Only report the versions and the update command; install nothing | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |