Two guides: start with the first one. The second explains everything you can add later – all of it is optional.
For advanced users
Everything here is optional. Most of it is under Settings → Advanced.
Choose your setup
| Cloud only | Cloud + bridge | Own server |
| Install at home | nothing | a small bridge (Docker, Home Assistant, Raspberry Pi) | PocketPrint3D server (Unraid, Home Assistant, Docker) |
| Slicing | in the cloud | in the cloud | at home |
| Printing at home | ✓ phone on the Wi-Fi | ✓ | ✓ |
| Printing from anywhere | – | ✓ also from the browser | ✓ with the bridge switch (or Tailscale) |
| Camera, controls, time-lapse | – | ✓ | ✓ |
| Extras | | | model library, AI failure detection, smart plug, exact Klipper times |
Control the printer
On the Printers tab, Control opens one page per printer with everything
else – never while a print runs:
- Temperatures with a chart, preheat PLA/PETG, cool down; fans, light, speed.
- Move: Home all axes, then move X, Y and Z in steps of 0.1 to 100 mm. Home first; careful when
lowering Z, the nozzle can touch the bed.
- Extruder and filament: choose the material (PLA 220 °C, PETG 250 °C …), then Load filament or
Unload filament – the nozzle heats up first, then the filament is pulled in or pushed out. To load, push the filament
into the extruder until it stops. On the Centauri Carbon this runs as a short job on the printer; on a Bambu Lab choose the
AMS tray.
- Macros (Klipper printers): the commands set up on your printer, e.g. cleaning the nozzle.
Print from anywhere (bridge)
- Run a bridge at home: on your own PocketPrint3D server switch on Connect to PocketPrint3D Cloud (Unraid
template, Home Assistant add-on option, or the server's web page → Settings). Without a server: the small Docker image
ghcr.io/halvar20000/printshare-bridge.
- The bridge shows a code (container log or its web page).
- In the app: Settings → Advanced → Print from anywhere, enter the code, Connect.
- The bridge's printers appear in your account, marked "through a bridge". More printers:
Add a printer through the bridge – address and password are encrypted so only your bridge can read them.
Only an outgoing connection: nothing to open in your router, your printers stay off the internet.
On your computer
- Open app.pocketprint3d.com and log in with the same e-mail – same printers, jobs and spools.
- Drag a model file onto the page to start.
- Printing from the browser works for printers behind a bridge. Others are marked "Phone only": start them in the app, or download the G-code.
Send from OrcaSlicer
Why through PocketPrint3D? OrcaSlicer can often reach your printer directly – but then
the print bypasses PocketPrint3D. Through PocketPrint3D:
- Spools stay right: the used filament is booked like for every other print.
- From anywhere: slice on the laptop at work, the printer at home prints – through your bridge.
- One overview: the print shows up in the app and the browser – preview, progress, camera, pause.
- Check first, start later: “Upload” gets the print ready; you start it on your phone once the plate is clear, and choose spool and slot there.
You don't manage spools and only print at home? Then sending directly from OrcaSlicer is just as good.
You don't add a new printer in OrcaSlicer – you give your real printer another way: through PocketPrint3D.
- In the app or browser: Settings → your printer → Send from OrcaSlicer on your computer →
Create access. You get an address and a key (shown once).
- In OrcaSlicer: Wi-Fi icon next to the printer (add physical printer) → host type Octo/Klipper → enter
address and key → Test.
- After slicing: Upload – the print waits as a job in the app. Upload and print – starts right away on a
printer behind a bridge and books the spool used last.
Filament spools
- Settings → Advanced → Filament spools: keep your spools in your PocketPrint3D account, or connect your own Spoolman.
- When printing, choose the spool per colour. You get a warning if one isn't enough or the material doesn't match.
- The used filament is booked when the print is finished. With spools in the account this also works when the app is closed (printers behind a bridge).
- New spools: pick them from the filament database, or hold the phone to an OpenPrintTag NFC spool (Android).
Time-lapse
- On the review screen switch on Record a time-lapse (off by default). The switch appears
for printers with a camera that your own server or a bridge reaches.
- While printing, one picture is taken per layer (Centauri Carbon, Klipper) or every 30 seconds (Prusa, OctoPrint).
- When the print is done, a short video is made. On the job: Watch the time-lapse –
with Download the video. It is deleted with the job after 14 days.
Bambu Lab printers (P1S, P1P, X1, A1)
- On the printer: Settings → WLAN, switch on LAN Only Mode;
with newer firmware also Developer Mode (shown below it). The 8-character
access code is on the same screen. Without LAN mode the printer shows its status but ignores print jobs
from other apps. In LAN mode it is no longer connected to the Bambu cloud (Bambu Handy).
- In the app: Add printer – the printer shows up as “Bambu Lab P1S” (Android,
at home) or through Add a printer through the bridge. Enter the access code; the printer model is
chosen for you.
- Printing: choose the AMS tray for every colour; the camera picture, time-lapse and the light work as
with other printers.
Your own camera (RTSP / webcam)
For printers behind a bridge: Settings → your printer → Own camera, enter e.g.
rtsp://user:password@192.168.1.60/live (Eufy: …/live0, Wyze: …/live, a Raspberry Pi with
mediamtx: rtsp://IP:8554/cam) or a webcam address (http://IP/capture for an ESP32-CAM). It replaces the
built-in camera for the picture, time-lapse and AI failure detection. Camera mounted on its side? Add
#rotate=90 (or 180, 270) to the address – PocketPrint3D turns the picture clockwise; it is never sent to the camera. The address is sent encrypted to the bridge.
Own server: camera_url: in config.yaml.
Multicolour (AFC / CANVAS)
For multicolour models choose the slot for every colour before preparing; empty slots are flagged, and the material
follows the filament in the slot. Supported on Klipper printers with AFC (e.g. Centauri Carbon with COSMOS + CANVAS).
Your own OrcaSlicer profiles
Settings → your printer → Printer profile: upload your OrcaSlicer printer, quality and material
profiles, or paste the link of a public Orca Cloud bundle. They are used for slicing right away.
Extras with your own server
- Your model library
- Manyfold at home shows up as a search source next to Printables.
- AI failure detection
- With Obico's ML API, camera pictures are checked while printing; a likely failure can pause the print.
- Printer on/off
- A smart plug in Home Assistant switches the printer on and off from the app.
- Exact times for Klipper
- Print times recalculated with your printer's own limits (klipper_estimator).
Installation and details: GitHub (README).
Something missing or not working? Open an issue there.