Voxeltron Docs
Get Started Free

Getting Started

Voxeltron is a two-binary system: voxeltrond (the Rust daemon that runs on your server) and voxeltron (the Go TUI you use to manage it). This guide gets you from zero to a running deploy.

No browser required. Voxeltron is managed entirely from your terminal via gRPC over TLS. Your web browser is not invited. It's for the best.

What you'll need

  • A Linux server (Debian/Ubuntu/Fedora/Arch — anything with Docker and systemd)
  • Docker 24+ installed on the server
  • A terminal on your local machine (macOS, Linux, or WSL2)
  • Ports 80, 443, and 7443 open on the server firewall
  • A domain name pointed at your server (for TLS)
Port 7443 is the gRPC management port. It never needs to be exposed publicly — you can tunnel it via SSH or put it behind a firewall. Port 80 and 443 are for your apps.

Quick Install

The fastest path: run the installer on your server.

$ curl -sSL https://voxeltron.dthink.ai/install.sh | bash

This installs both voxeltrond and voxeltron to /usr/local/bin. The installer detects your OS and pulls the correct binary.

You can verify the install:

$ voxeltron --version
voxeltron v0.8.0 (go1.22, linux/amd64)

$ voxeltrond --version
voxeltrond v0.8.0 (rust 1.82, linux/amd64)

Start the daemon

$ voxeltrond start
✓ Daemon started
✓ gRPC listening on 0.0.0.0:7443 (TLS)
✓ Reverse proxy listening on 0.0.0.0:80 and 0.0.0.0:443
✓ State stored at /var/lib/voxeltrond/

For production use, the installer creates a systemd service. Enable it:

$ sudo systemctl enable --now voxeltrond

Connect the TUI

On your local machine (or the server itself), launch the TUI:

$ voxeltron
✓ Connected to voxeltrond v0.8.0 at localhost:7443
  0 services running · uptime 0m · 2 CPUs · 2.0 GB RAM

If connecting from a remote machine, pass the host:

$ voxeltron --host my-server.example.com:7443
The TUI uses Vim-style keybindings. Press ? at any time to see the help overlay. Press q to go back. Press ctrl+a to open the AI panel.

What's next?

📦
Full Installation Guide
Detailed install for different platforms, from source, and post-install verification.
🚀
Your First Deployment
Deploy a Docker image or a GitHub repo to your server in under 5 minutes.
🗄️
Databases
Provision and manage Postgres, MySQL, Redis, and MongoDB from the TUI.
🤖
AI Integration
Connect the AI panel to your preferred model and let it fix your infra.
Installation →