Getting Started¶

Welcome to BamDude! This guide will help you get your print farm management system up and running quickly.

Quick Install¶

Docker (Recommended) Python

git clone https://github.com/kainpl/bamdude.git
cd bamdude
docker compose up -d

Open http://localhost:8000 in your browser.

Full Docker Guide

git clone https://github.com/kainpl/bamdude.git
cd bamdude
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn backend.app.main:app --host 0.0.0.0 --port 8000

Open http://localhost:8000 in your browser.

Full Installation Guide

Next Steps¶

Enable Developer Mode¶

Enable Developer Mode on your printer and note the access code.

See instructions

Add Your Printer¶

Enter your printer's IP, access code, and serial number.

Add first printer

Start Printing!¶

BamDude automatically archives every print and manages your queue.

Explore features

Enabling Developer Mode¶

BamDude connects to your printer via Developer Mode -- a local connection that provides full control without internet.

Why Developer Mode?

Developer Mode provides direct communication between BamDude and your printer over your local network:

Works offline -- No internet required
Full control -- Start/stop prints, upload files, control lights
Your data stays local -- No cloud dependency

Developer Mode vs LAN Only Mode

Since the January 2025 firmware update, standard LAN Only Mode (without Developer Mode) only provides read-only access. Developer Mode is required for full functionality with BamDude.

Step 1: Enable LAN Only Mode¶

On your printer's touchscreen, go to Settings
Navigate to Network or WLAN
Toggle LAN Only Mode to ON

Step 2: Enable Developer Mode¶

After enabling LAN Only Mode, a Developer Mode option will appear
Toggle Developer Mode to ON
Note down the Access Code displayed (8 characters)

Access Code Changes

The access code changes every time you toggle these modes off and on. If you re-enable Developer Mode, you'll need to update the access code in BamDude.

Step 3: Insert SD Card¶

SD Card Required

An SD card must be inserted in your printer for BamDude to work properly. The SD card is required for file transfers, starting prints, and archiving completed prints.

Step 4: Gather Printer Information¶

You'll need these details to add your printer:

Information	Where to Find
IP Address	Settings Network
Serial Number	Settings Device Info
Access Code	Shown when Developer Mode is enabled

What's Next?¶

Add Your Printer
Connect your first printer

Print Archiving
How automatic archiving works

Notifications
Get alerts on your phone

Troubleshooting
Having issues?

Originally based on Bambuddy documentation.