Documentation

Full docs ship with the appliance. This page will be updated at launch.

How it works

VDX is a turnkey appliance built on Ubuntu 26.04. Download the ISO, boot it on any amd64 machine — bare metal or a VM — and it installs itself. Once the installer finishes, your node is running and ready to launch desktop sessions. No manual configuration, no agent installs, no dependencies to manage.

The web console runs on the node at port 8766. Open it in any browser, log in, and you can launch sessions, manage users, and monitor the cluster — all without touching the command line.

Quick start

  1. 1.
    Download the ISO
    Get the latest VDX ISO from the download page. Verify the SHA256 checksum before booting.
  2. 2.
    Boot and install
    Write the ISO to a USB drive or mount it as a VM disk image. Boot from it. The installer runs unattended — it partitions the disk, installs the base system, and sets up the VDX daemon automatically.
  3. 3.
    Open the web console
    After reboot, browse to http://<node-ip>:8766. Create your admin account on first login.
  4. 4.
    Register with VDX Cloud
    Paste your API key from the dashboard into the node settings screen. This activates your license and enables automatic image updates. Free tier nodes get 5 seats — no credit card required.
  5. 5.
    Launch a session
    Click Launch session in the console, pick your desktop image, and hit start. A full Linux desktop opens in your browser in under a minute.

vdxd TUI

SSH into any node and run vdxd with no arguments to open the interactive terminal dashboard. It shows live session status, cluster health, seat usage, image cache, and lets you launch or stop sessions without leaving the terminal — useful for headless environments or scripted management over SSH.

The web console at port 8766 and the TUI expose the same functionality. Use whichever fits your workflow.

Cluster setup

To add a second node, install VDX on another machine and register it with the same API key. Nodes on the same LAN find each other automatically. Sessions launched on any node appear in every node's console. The scheduler places new sessions on whichever node has capacity.

Full documentation — hardware compatibility list, network requirements, enterprise SSO setup, custom image builds, and the cluster API reference — will be published at launch alongside the first public ISO release.