Getting Started
FDM Foreman is print farm management software built for 3D printer operators. It lets you monitor every printer in real time, manage your job queue, track filament spools, schedule maintenance, run quality control checks, and understand your costs — all from one dashboard.
It works with Klipper/Moonraker, OctoPrint BETA, Prusa Connect, and Bambu Lab printers.
Every new account gets a 14-day free trial — no credit card required. You get full access to all features during the trial period.
After 14 days, you'll be prompted to choose a plan to continue. If you don't subscribe, the app will lock until you do.
Click Start Free Trial on any page. You'll pick a plan, enter your farm name and account details, and be logged straight in — the 14-day trial starts immediately.
You can access the app at app.fdmforeman.com.
Connecting Printers
FDM Foreman currently supports:
- Klipper / Moonraker — Neptune 4, Ender 3 with Klipper, most DIY builds
- OctoPrint BETA BETA — any printer running OctoPi on a Raspberry Pi
- Prusa Connect — MK4, XL, MINI+
- Bambu Lab — X1, P1, A1 series
- Manual mode — any printer, without live monitoring
For Klipper and OctoPrint BETA printers, you install a small agent on the device running your printer software (usually a Raspberry Pi or the printer's built-in board).
- 1In the app, go to Printers → Add Printer, choose your printer type and save.
- 2A unique token will appear. Copy the one-line install command shown.
- 3SSH into your printer's device and paste the command.
- 4The agent installs and connects automatically. Your printer appears live within seconds.
curl -sSL https://fdmforeman.com/install.sh | TOKEN=YOUR_TOKEN bashThe token is shown the moment you add a printer. If you closed that dialog, you can retrieve it at any time — go to Printers, find the printer in the list, and click the key icon 🔑 on that row. The install command with your token will reappear.
MKS / Makerbase boards (Neptune 4 series and similar):
ssh mks@YOUR_PRINTER_IP # Username: mks
# Password: makerbaseRaspberry Pi-based Klipper (MainsailOS, FluiddPI):
ssh pi@YOUR_PRINTER_IP # Username: pi
# Password: raspberryssh pi@octopi.local # Username: pi
# Password: raspberryThe OctoPrint BETA web interface login is whatever you set during the first-run wizard — there is no universal default.
Agent Management
The agent is a small Python script that runs in the background on your printer's device. It:
- Reads printer status, temperatures, and print progress via the Moonraker/OctoPrint BETA API
- Sends that data securely to FDM Foreman so you can see it in the dashboard
- Does not modify any Klipper, Moonraker, or OctoPrint BETA settings
- Does not start, stop, or interfere with your print jobs
- Does not access your G-code files or STL files
SSH into your printer's device and run these two commands to stop and disable the agent service:
# Stop the agent immediately
sudo systemctl stop fdmforeman
# Disable it so it doesn't restart on reboot
sudo systemctl disable fdmforemanTo check it has stopped:
sudo systemctl status fdmforeman# Stop the agent immediately
sudo systemctl stop fdmforeman
# Disable it so it doesn't restart on reboot
sudo systemctl disable fdmforemanTo check it has stopped:
sudo systemctl status fdmforemanSSH into your printer's device and run:
# Stop and disable the service
sudo systemctl stop fdmforeman
sudo systemctl disable fdmforeman
# Remove the service file
sudo rm /etc/systemd/system/fdmforeman.service
sudo systemctl daemon-reload
# Remove the agent files
rm -rf ~/.fdmforemanTo restart a running agent:
sudo systemctl restart fdmforemanTo reinstall from scratch, get your token from the app (Printers → key icon 🔑) and run the installer again:
curl -sSL https://fdmforeman.com/install.sh | TOKEN=YOUR_TOKEN bashBilling & Plans
No — the 14-day free trial requires no credit card. You only need to add payment details when you choose to subscribe after the trial.
After 14 days without an active subscription, the app will display a trial expired screen. You can still log in, but you'll need to subscribe to access the dashboard again.
Your data is not deleted — everything is preserved when you subscribe.
You can cancel at any time from inside the app. Go to Settings → Billing and click Manage Subscription. This opens the Stripe billing portal where you can cancel, change plan, or update your payment method.
Cancellation takes effect at the end of your current billing period — you keep access until then.
Yes — go to Settings → Billing → Manage Subscription to upgrade or downgrade at any time. Changes take effect immediately and are prorated.
Troubleshooting
Check the following:
- 1Make sure the printer's device (Pi / board) is powered on and connected to your network.
- 2SSH in and check the agent is running:
sudo systemctl status fdmforeman - 3If it's stopped, restart it:
sudo systemctl restart fdmforeman - 4Check Moonraker/OctoPrint BETA is running on the device and accessible at its normal IP address.
Check the agent logs for errors:
sudo journalctl -u fdmforeman -n 50 --no-pagerCommon causes:
- Wrong IP address entered when adding the printer in the app
- Moonraker/OctoPrint BETA not running on the default port
- Firewall blocking outbound connections from the device
- Token was already used — get a fresh token from the key icon 🔑 and reinstall
Email us at hello@fdmforeman.com or use the contact form and we'll get back to you as quickly as we can.
You can also message us on WhatsApp: 07488 370484