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.
| Option | Effect |
|---|---|
--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) |
--virtuelle | The 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.