CLI Reference
Complete command reference for the voxeltron TUI client and voxeltrond daemon.
TUI Commands
The voxeltron binary is the interactive terminal client. Run it without arguments to launch the full TUI, or use subcommands for quick actions.
| Command | Description |
| voxeltron | Launch the interactive TUI dashboard |
| voxeltron connect <host> | Connect to a remote daemon instance |
| voxeltron deploy <path> | Deploy an application from the given path |
| voxeltron logs <app> | Stream live logs for an application |
| voxeltron db create <engine> <name> | Create a managed database (postgres, mysql, redis, mongo) |
| voxeltron db list | List all managed databases |
| voxeltron plugin install <path> | Install a plugin from a local path or URL |
| voxeltron plugin list | List installed plugins and their status |
| voxeltron backup create | Create a backup of all apps and databases |
| voxeltron secret set <key> <value> | Set an environment secret for the current app |
| voxeltron version | Show the TUI client version |
Daemon Commands
The voxeltrond binary is the server-side daemon. It manages containers, routing, databases, and the gRPC API.
| Command | Description |
| voxeltrond | Start the daemon in the foreground |
| voxeltrond --config <path> | Start with a custom configuration file path |
| voxeltrond migrate | Run pending database migrations |
| voxeltrond version | Show the daemon version |
Global Flags
These flags can be passed to any TUI command to override connection and configuration defaults.
| Flag | Description |
| --host <address> | Daemon host address (default: 127.0.0.1) |
| --port <number> | Daemon gRPC port (default: 9090) |
| --tls-skip-verify | Skip TLS certificate verification (development only) |
| --config <path> | Path to configuration file (default: ~/.config/voxeltron/config.toml) |
Use voxeltron <command> --help to see detailed usage for any subcommand. The TUI also provides inline help via the ? key.
Quick Examples
Deploy an app
voxeltron deploy ./my-app
Connect to remote host
voxeltron connect 10.0.1.5 \
--port 9090
Create a database
voxeltron db create postgres mydb
Set a secret
voxeltron secret set \
DATABASE_URL "postgres://..."
