Skip to content

OctoPrint

Bridge connects to any printer running OctoPrint via its REST API.

Supported Printers

Any 3D printer connected to an OctoPrint instance — this includes printers from Creality (Ender series), Prusa, Anycubic, and many others when connected to a Raspberry Pi or similar device running OctoPrint.

What You Need

FieldWhere to Find It
IP AddressThe IP of your OctoPrint server (Raspberry Pi, etc.). Visit http://octopi.local or check your router.
API KeyOctoPrint web UI: Settings (wrench icon) > API > Global API Key. Copy the key.

Setup Steps

  1. Open your OctoPrint web interface and get the API key from Settings > API
  2. In Bridge, click Add Printer
  3. Set Platform to OctoPrint
  4. Enter the IP Address of your OctoPrint server
  5. Enter the API Key
  6. (Optional) Set Port if OctoPrint isn't on the default port 80
  7. (Optional) Enable SSL if you've configured HTTPS on OctoPrint
  8. Click Save

Connection Details

SettingValue
ProtocolREST API (HTTP polling)
Default Port80 (HTTP) or 443 (HTTPS)
AuthenticationAPI Key header
Endpoints/api/printer, /api/job

What Bridge Reports

  • Nozzle and bed temperatures (current and target)
  • Print state (printing, paused, idle, etc.)
  • Current file name and print progress
  • SD card status

Troubleshooting

  • 401 Unauthorized? Double-check the API key. Make sure you copied the Global API Key, not a user-specific key.
  • Connection refused? Make sure OctoPrint is running and accessible. Try visiting the OctoPrint URL in your browser.
  • Wrong port? If OctoPrint is behind a reverse proxy (like HAProxy or Nginx), you may need to specify the correct port.
  • SSL errors? If using self-signed certificates, you may need to disable SSL verification or use HTTP instead.