Documentation
Short, practical guides. Start with installation, add a machine, wire your first workflow, and you'll be running production batches before lunch. The rest is reference you can come back to.
Get started in 5 minutes
The shortest path from a fresh install to your first running job.
-
1
Install the server
Run the Windows installer and open the address shown by the launcher on any device on your Wi-Fi.
Read →
-
2
Connect a machine
Plug in a USB-serial board, or point the UI at a Wi-Fi or TCP controller. Pick its firmware protocol and set the working area.
Read →
-
3
Run your first job
Drop an SVG in the local folder, pick the default interface, target your machine, hit Run.
Read →
Getting started
Install, sign in, and reach the UI from your phone or tablet.
Installation
Install GRBL Server on the workshop computer and open the web UI from any device on the same Wi-Fi.
Login & accounts
Sign in once per host, work everywhere on the network. What to do when something's off with your account.
Core concepts
The five building blocks every job is made of: machines, interfaces, presets, jobs, workflows.
Connecting machines
Add machines over USB serial, Wi-Fi or TCP, speaking GRBL, GRBL-ESP32, Marlin, Smoothieware, Klipper or generic G-code.
Creating jobs
Turn an SVG, DXF or image into a G-code job, target a machine, run it. The one-off path.
Workflow basics
Wire reusable production pipelines from nodes: mediators, interfaces, presets, grids, machines.
Presets & interfaces
Save material-specific recipes once and apply them with one click on future jobs.
Production
Production-scale features that turn a folder of designs into a sheet of engraved or cut pieces.
Grids
Tile jobs across the working area in a configurable rows × columns layout with gaps.
Clipping & cropping
Constrain a job to an SVG d path or a rectangular bound — fits production to the material you have.
Help
When something doesn't work the way you expect.
Troubleshooting
Common issues with login, licence validation, the server, USB drivers, WebSocket controllers, alarms, and the pre-visualizer.
Glossary
The names that show up everywhere in GRBL Server. If you've ever wondered "what's a mediator again?", start here.
- Machine
- A controller registered with the server, reached over USB serial, Wi-Fi or TCP.
- Transport
- How a machine is wired to the server: USB serial, Wi-Fi (WebSocket), or TCP.
- Protocol
- The firmware family a machine speaks — GRBL, GRBL-ESP32, Marlin, Smoothieware, Klipper, or generic G-code.
- Interface
- The engine parameters used to turn a file into G-code: power, speed, passes, fill density. One interface covers vector, raster, and SVGs that combine both.
- Sequence
- Start / end G-code that wraps a job (e.g. homing, raise Z, fan on).
- Job
- A single G-code execution targeted at one machine.
- Job preset
- A reusable bundle of machine + interface + clipping + grid for a specific material.
- Mediator
- A file source that pulls files from an external database with a SQL query (parameters injected at run time).
- Workflow
- A reusable production pipeline built from nodes and connections.
- Workflow run
- A tracked, step-by-step execution of a workflow, with per-job state and error handling.
- Pre-visualizer
- A 2D canvas showing the working area and where a job will land before running.
- Grid node
- A workflow node that arranges multiple jobs across the working area in rows × columns.
- Clip / Crop
- Restricts a job to an SVG
dpath (clip) or a rectangle (crop). - Jobs linker
- A workflow node that combines several setup-job branches into a single output.
Can't find what you need?
These docs grow with beta feedback. If something is missing, vague, or wrong, tell me — it's the fastest way to make them better.