Skip to content

Dusty Link and Hub mode

Installing Dusty Link

Install the Dusty Link service on a Raspberry Pi or a Linux PC with one command line, or on Windows, with its options, pairing code and 3D printer safeguard.

On a Raspberry Pi or a Linux PC (with systemd and Internet), plug the CNC over USB, then in a terminal:

curl -fsSL https://dusty.websolutis.com/link/install.sh | sudo sh

The script takes the package of the operating system (64-bit Raspberry Pi OS or other 64-bit ARM, 32-bit ARM for every Raspberry Pi running a 32-bit system, 64-bit PC), checks its SHA-256 sum, installs the dusty-hub service (system user dusty, dialout group) and shows the pairing code and the Dusty Studio address (http://<computer name>.local:46590/). The same line updates Dusty Link. Options go after sh -s --, for example … | sudo sh -s -- --port /dev/ttyUSB0 --nom Workshop.

OptionEffect
--port <port>The CNC’s port (otherwise: every USB port where a GRBL controller answers)
--ignorer <port>Port kept for another device, never opened (repeatable); preferably /dev/serial/by-path/…
--reseau <host[:port]>CNC over Wi-Fi or Ethernet (Telnet, port 23 by default)
--machine <identifier>Profile of a machine from Dusty’s catalog
--profil <machine.json>Profile exported from Dusty’s machine list
--nom <name>Name shown to devices (“Dusty Link” by default)
--virtuelleThe virtual CNC, to try everything without a machine

A 3D printer on the same computer (often with the same CH340 USB chip as a 3018-type CNC): Dusty Link only keeps a port where a GRBL controller answers. A printer that announces itself (Marlin, Klipper) is set aside without receiving anything; otherwise it only receives two read-only questions (? then $I), once per plug-in, and its port stays free for its own software. To never touch its port, keep it with --ignorer. Linux’s phantom serial ports (/dev/ttyS… slots with no hardware) are not offered.

The pairing code stays the same from one start to the next, power cuts included; it only changes after too many wrong codes. To see it again: sudo dusty-hub --code. The service starts with the computer, reconnects to the machine after a cut (CNC switched off, cable unplugged) and announces itself on the network (Bonjour / mDNS): the apps find it without typing an address. The QR code of the mobile pendant, to scan with a phone: sudo dusty-hub --pendant.

On Windows, unzip the dusty-link folder, then in a command prompt: dusty-hub.exe --studio studio. The code shows in the window; keep it open and allow Dusty Link on the private network if Windows asks.

The full installation guide (packages, ARM boards, installing without Internet) comes in every package (LISEZ-MOI.md).

This manual is also built into Dusty: press F1, or open the Help menu, to read the topic for what you are doing. A mistake, a missing answer? Tell us

Try it in Dusty, for free.

Free CNC milling software: design, toolpaths and machine control. Mac, iPad, iPhone, Windows and Linux.