CutCutBoom Cutting machine automation
Back to Blog

Deploying CutCutBoom: From Windows to Raspberry Pi

| 1 min read
deploymentsetupcross-platform

CutCutBoom is built with Node.js and works on Windows, macOS, Raspberry Pi, and Linux. Here’s how to get it running.

System Requirements

  • Node.js: 18.x or higher
  • npm: 9.x or higher
  • RAM: 512MB minimum (1GB recommended)
  • Disk: 200MB for application + queue files
  • Serial port: USB or COM port for hardware connection

Quick Start

Windows

git clone https://github.com/RobotX5/cutcutboom-software.git
cd cutcutboom-software/server
npm install
set PORT=3200
node dist/index.js

Then open http://localhost:3200 in your browser.

Raspberry Pi (Raspbian)

sudo apt update && sudo apt install nodejs npm
git clone https://github.com/RobotX5/cutcutboom-software.git
cd cutcutboom-software/server
npm install
PORT=3200 node dist/index.js

Production Deployment

For persistent operation, use systemd:

sudo nano /etc/systemd/system/cutcutboom.service
[Unit]
Description=CutCutBoom Automation Platform
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/cutcutboom-software/server
ExecStart=/usr/bin/node dist/index.js
Restart=always
Environment="PORT=3200"

[Install]
WantedBy=multi-user.target

Then enable it:

sudo systemctl enable cutcutboom
sudo systemctl start cutcutboom

Troubleshooting

Port already in use: Change PORT environment variable Serial port not detected: Check device permissions with ls /dev/ttyUSB* npm install fails: Update Node.js to latest LTS

See GitHub README for full docs.