No description, website, or topics provided.
Clone or download
Latest commit 7d92fb2 Mar 24, 2016
Failed to load latest commit information.
bin split exec file Sep 26, 2015
browser improve performance Mar 24, 2016
clients update Aug 31, 2015
config TLS settings Sep 22, 2015
dev http2 Sep 22, 2015
out use key polyfill Oct 4, 2015
service add service Aug 15, 2015
sketch gcode viewer Sep 9, 2015
typings update ipaddress check Sep 26, 2015
.gitignore vulcanize Sep 22, 2015
Makefile split exec file Sep 26, 2015
Procfile add Procfile for node-foreman (npm install -g foreman) Aug 18, 2015 Fix Typo and missing info Oct 22, 2015
client.ts connection Aug 6, 2015
dtsm.json init Aug 6, 2015
gcode.ts progress in 3d view Sep 19, 2015
grbl.ts add version strings Sep 18, 2015
grblserver-product-icon.psd update icons Sep 21, 2015
package.json version Sep 26, 2015
server.ts split exec file Sep 26, 2015
sketch.ts update Aug 13, 2015
test.ts update Sep 11, 2015
tsconfig.json update Aug 13, 2015


GrblServer is a Grbl interface for standalone gcode execute service which works with nodejs.

GrblServer provides:

  • WebSocket APIs
  • Multiple session for one Grbl (broadcast Grbl state to all clients) This is useful for show state in multiple view (eg. local LCD and remote browsers)


Standalone WebApp

By "Add to Home screen" feature on Chrome for Android.

Responsive View

Install & Basic Usage

You must install node.js and git.

Clone repository to local

git clone

Install dependencies

cd GrblServer
npm install


Create config/local.json. You must edit "serialPort" path.

cp config/default.json config/local.json
vi config/local.json

Run GrblServer

You should connect Grbl installed Arduino before running.

node bin/grbl-server.js

Open client by browser

Google Chrome is recommended for performance.

open http://localhost:8080/

(GrblServer also serves static files under ./browser)



Specify WebSocket/HTTP server port to serve.


Specify serial port path which is connected to Grbl.


Specify serial baudrate to Grbl.

You want to write configuration with other formats? You can:


Specify TLS key/cert for HTTP2. Default is empty (disabled).

GrblServer includes localhost cert (self signed certificates). Use it by following:

"TLSKey" : "dev/server.key",
"TLSCert" : "dev/server.crt" 

Or create self signed certificates by dev/


Jogging by smartphone's browser

with Raspberry Pi


Ensure that NodeJS has been installed on the Rapsberry Pi (

Clone GrblServer on Raspberry Pi:

mkdir app
cd app
git clone
cd GrblServer
npm install

Create config/local.json. You must edit "serialPort" path.

cp config/default.json config/local.json
vi config/local.json

Edit /etc/inittab to auto login by user pi:

sudo vi /etc/inittab

# comment out following line:
# 1:2345:respawn:/sbin/getty --noclear 38400 tty1 
# and add following line:
1:2345:respawn:/bin/login -f pi tty1 </dev/tty1 >/dev/tty1 2>&1

Edit /etc/rc.local to auto launch GrblServer:

sudo vi /etc/rc.local
# add following line before exit
sudo -u pi /home/pi/app/GrblServer/service/


GrblServer is written in TypeScript.

sudo npm install -g typescript
npm install
make watch # tsc watch
make server # launch websocket/http server

browser client is written JavaScript with Polymer

Above make server also serves static files under browser/.

Grbl for development

You may need actual connection to Grbl. But you should not connect to Grbl which connected to powered CNC machine. So I suggest you to make another Grbl installed Arduino and use it for development.

Grbl is open-loop control except homing and probing. It means you don't need to connect actual CNC machine in most case.


Send pull-request.