Installation

Voxeltron ships as two static binaries: the daemon (voxeltrond) and the TUI client (voxeltron). No runtime dependencies. No package manager drama. Just copy and run.

Method 1: Install Script (Recommended)

The fastest way to get started. Run this on your server:

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

The script:

Detects your OS and architecture
Downloads the latest release binaries from GitHub
Installs them to /usr/local/bin
Creates a voxeltrond.service systemd unit
Creates a voxeltron user with minimal privileges

Always inspect installer scripts before running them. You can view the source at github.com/voxeltron/voxeltron. Or use Method 2 below for a manual install.

Method 2: Manual Binary Install

Download the binaries

Find the latest release on GitHub and download for your platform:

# Linux x86_64 (most servers)
$ curl -LO https://github.com/voxeltron/voxeltron/releases/latest/download/voxeltrond-linux-x86_64.tar.gz
$ curl -LO https://github.com/voxeltron/voxeltron/releases/latest/download/voxeltron-linux-x86_64.tar.gz

# macOS (for local TUI only)
$ curl -LO https://github.com/voxeltron/voxeltron/releases/latest/download/voxeltron-darwin-arm64.tar.gz

Verify the checksums

$ curl -LO https://github.com/voxeltron/voxeltron/releases/latest/download/SHA256SUMS
$ sha256sum --check SHA256SUMS --ignore-missing

Install the binaries

$ tar -xzf voxeltrond-linux-x86_64.tar.gz
$ tar -xzf voxeltron-linux-x86_64.tar.gz
$ sudo mv voxeltrond voxeltron /usr/local/bin/
$ sudo chmod +x /usr/local/bin/voxeltrond /usr/local/bin/voxeltron

Create the systemd service

$ sudo tee /etc/systemd/system/voxeltrond.service <<'EOF'
[Unit]
Description=Voxeltron Daemon
After=network.target docker.service
Requires=docker.service

[Service]
Type=simple
User=voxeltron
ExecStart=/usr/local/bin/voxeltrond start
Restart=always
RestartSec=5
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target
EOF

$ sudo useradd -r -s /bin/false voxeltron
$ sudo systemctl daemon-reload
$ sudo systemctl enable --now voxeltrond

Method 3: Build from Source

For contributors or the deeply suspicious:

# Prerequisites: Rust 1.82+, Go 1.22+

$ git clone https://github.com/voxeltron/voxeltron
$ cd voxeltron

# Build the daemon
$ cargo build --release -p voxeltrond

# Build the TUI
$ cd tui && go build -o voxeltron ./cmd/voxeltron

Post-Install Verification

# Check versions
$ voxeltrond --version
voxeltrond v0.8.0

$ voxeltron --version
voxeltron v0.8.0

# Check daemon health
$ voxeltrond status
● voxeltrond.service - Voxeltron Daemon
   Active: active (running) since 2026-02-20 09:14:22 UTC
   Memory: 47.2M
   Uptime: 2h 14m 8s

Firewall Configuration

Open the required ports on your server:

# UFW (Ubuntu/Debian)
$ sudo ufw allow 80/tcp    # HTTP (redirected to HTTPS)
$ sudo ufw allow 443/tcp   # HTTPS
$ sudo ufw allow 7443/tcp  # gRPC management (restrict to your IP!)

# Better: restrict gRPC to your IP
$ sudo ufw allow from YOUR_IP to any port 7443

If you restrict port 7443 to your IP, you'll need to SSH tunnel to manage the daemon from other locations: ssh -L 7443:localhost:7443 user@server

Uninstall

$ sudo systemctl disable --now voxeltrond
$ sudo rm /usr/local/bin/voxeltron /usr/local/bin/voxeltrond
$ sudo rm /etc/systemd/system/voxeltrond.service
$ sudo rm -rf /var/lib/voxeltrond  # WARNING: deletes all state