Installation Overview
This page helps you choose the right way to install AxioCNC and points you to the correct guide.
Installation Methods
Headless
| Method | Best for | Access |
|---|---|---|
| Docker | Servers, CI, or consistent environments | Docker |
| Raspberry Pi Server | Headless Pi (no display) | Pi Server |
| Linux Headless | Headless Linux server | Linux Headless |
Desktop Apps
| Method | Best for | Access |
|---|---|---|
| Windows Desktop | Daily use on a Windows PC | Windows |
| macOS Desktop | Daily use on a Mac | Mac |
| Linux Desktop | Daily use on a Linux PC | Linux |
| Raspberry Pi | Dedicated machine in the shop | Raspberry Pi |
Quick Comparison
Headless Installations
- Docker — Use when you already run Docker, or want isolated, reproducible setups. Good for headless servers.
- Raspberry Pi Server — Use when you want a small, always-on headless machine in the shop (no display).
- Linux Headless — Use when you want to run AxioCNC on a headless Linux server.
Desktop Installations
- Desktop installers (Windows .exe, Mac .dmg, Linux .deb) — Easiest. Install and run. Use when AxioCNC runs on the same machine you use to control the CNC.
- Raspberry Pi — Use when you want a small, always-on machine in the shop with a display.
Downloads
All installers and packages are on GitHub Releases. You can also download from axiocnc.com.
After Installation
- Run AxioCNC — Desktop apps open a browser at
http://localhost:8000. Headless/server: open that URL from any device on your network. - Serial port access — On Linux and Raspberry Pi, add your user to the
dialoutgroup, then log out and back in. See your platform guide. - Configure connection — Go to Settings → Connection. Set port, baud rate (often 115200 for Grbl), and controller type.
Next Steps
- First use — Launch and quick tour
- Connecting to your machine — Port, baud, controller