The AxonOS Launcher

The AxonOS Launcher is a tool for building and deploying AxonOS. The CLI is designed for headless GPU servers; an optional GUI is available on systems with a display.

What it does

• Application selection — choose which scientific apps to include from the full suite.
• Smart build system — uses the stock Dockerfile for default configs (faster) or generates a custom Dockerfile only when needed.
• Ollama model configuration — pick which AI models to install.
• User settings — set the desktop username and VNC password.
• GPU support — toggle GPU acceleration with automatic docker run generation.
• One-click deployment — build, deploy, and open the browser automatically.
• Config management — save and load build configurations as JSON.
• Real-time build logging — stream Docker build progress live.

CLI quick start

git clone https://github.com/AXDT-INC/AxonOS.git
cd AxonOS

axonos list                                      # show available apps
axonos build --password "$AXONOS_VNC_PASSWORD"   # build the image
axonos deploy --gpu                              # deploy with GPU + open browser

See the complete CLI Reference for every command and flag.

GUI mode

On a machine with a display:

axonos --gui

Use the customizer to select applications, configure AI models, set credentials, and build & deploy with one click. The launcher detects default configurations and uses the optimized build path automatically.

Available applications

The launcher lets you customize which applications are included:

Configuration file

Save and reuse a build configuration as JSON:

{
  "applications": {
    "jupyterlab": true,
    "r_rstudio": true,
    "spyder": false,
    "ugene": true
  },
  "ollama_models": ["gemma4:31b", "granite3.2-vision"],
  "username": "aXonian",
  "password": "REPLACE_WITH_STRONG_PASSWORD",
  "image_tag": "axonos:latest",
  "gpu_enabled": true
}

axonos config save --file my-config.json
axonos build --config my-config.json --password "$AXONOS_VNC_PASSWORD"