Skip to main content

Installing AxioCNC on Linux

Install the .deb package on Debian/Ubuntu (x64), then run AxioCNC from the command line or your app launcher.

Prerequisites​

  • Debian or Ubuntu (x64)
  • Node.js 18+ (usually satisfied by the package)

Steps​

  1. Download and install the package

    curl -L -o axiocnc-desktop_0.0.89_amd64.deb https://github.com/rsteckler/AxioCNC/releases/download/v0.0.89/axiocnc-desktop_0.0.89_amd64.deb
    sudo dpkg -i axiocnc-desktop_0.0.89_amd64.deb
    sudo apt-get install -f   # if dependencies are missing

  2. Add your user to the dialout group (for serial port access)

    sudo usermod -a -G dialout $USER

    Log out and back in (or reboot) for this to take effect.

  3. Run AxioCNC

    axiocnc

    A browser window opens at http://localhost:8000. You can also open that URL manually.

Verify Serial Port Access​

After logging back in:

groups $USER                    # should include "dialout"
ls -l /dev/ttyUSB* /dev/ttyACM* # list serial devices

Troubleshooting​

Port not found or permission denied

  • Confirm you’re in dialout: groups $USER
  • Log out and back in after usermod
  • Ensure the controller is plugged in and powered: ls -l /dev/ttyUSB* /dev/ttyACM*

Port 8000 already in use

axiocnc --port 8001

Uninstall

sudo apt-get remove axiocnc

See Uninstall for removing config files.

Next Steps​