Repolode
Submit
TheSpaghettiDetective

TheSpaghettiDetective/obico-server

Self-hosted server for Obico, an open-source smart 3D printing platform with AI failure detection for OctoPrint and Klipper printers.

Open-source alternative to:Obico Cloud

View on GitHubWebsite
Stars
1,929
Forks
364
Open issues
146
Last commit
yesterday

What is it?

The Obico Server is the self-hosted backend for Obico, a community-built platform for monitoring and managing 3D printers. Once running, it lets OctoPrint or Klipper printers connect to a server you control, so you can keep print data and webcam streams on your own hardware instead of a hosted service.

The server includes deep learning based AI failure detection that watches the print job for problems. It runs as a set of containers started with Docker Compose, and the project's README describes a setup that needs only a standard computer, with an optional Nvidia GPU for faster inference and more printers per server. Clients include the Obico plugin for OctoPrint and the Obico mobile app.

Setup involves configuring the server's LAN IP address, updating the Django site domain, and enabling SMTP email delivery. Gmail is not usable for SMTP since Google removed that option in 2022.

Key features

  • 01Self-hosted server that keeps print data and webcam streams on your own machine
  • 02Deep learning based AI print failure detection
  • 03Works with OctoPrint and Klipper printers through the Obico plugin
  • 04Runs via Docker Compose on standard hardware, with optional Nvidia GPU acceleration
  • 05Supports RK3588 NPU acceleration through an extra compose file

Use cases

  • Monitoring home 3D printers over a LAN without sending video to a cloud service
  • Running AI failure detection on prints from OctoPrint or Klipper setups
  • Hosting a private Obico instance for a makerspace or small group of printers

Quick start

  1. 1

    Clone the release branch from GitHub

    git clone -b release https://github.com/TheSpaghettiDetective/obico-server.git
  2. 2

    Start the server with Docker Compose (Linux)

    cd obico-server && sudo docker compose up -d
  3. 3

    Wait 15-30 minutes for the first start, then open http://localhost:3334 in a browser

Things to know

  • Requires Docker and Docker Compose V2 or higher, plus an SMTP-enabled email account (Gmail does not work).
  • The default admin login is public in the README, so you must change the admin password after setup.
  • Initial setup requires configuring the server IP and Django site domain before OctoPrint can connect.

In collections

Self-hosted appsComputer vision libraries & tools

Topics

#3d-printing#self-hosted#docker#computer-vision#deep-learning#octoprint#klipper#iot

FAQ

What is obico-server?
Self-hosted server for Obico, an open-source smart 3D printing platform with AI failure detection for OctoPrint and Klipper printers. The Obico Server is the self-hosted backend for Obico, a community-built platform for monitoring and managing 3D printers. Once running, it lets OctoPrint or Klipper printers connect to a server you control, so you can keep print data and webcam streams on your own hardware instead of a hosted service.
Is obico-server free to use? What license does it have?
obico-server is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is obico-server still maintained?
Actively maintained. The last commit to obico-server was on Nov 6, 2026.
What can I use obico-server for?
Monitoring home 3D printers over a LAN without sending video to a cloud service Running AI failure detection on prints from OctoPrint or Klipper setups Hosting a private Obico instance for a makerspace or small group of printers
How do I install obico-server?
Clone the release branch from GitHub: git clone -b release https://github.com/TheSpaghettiDetective/obico-server.git Start the server with Docker Compose (Linux): cd obico-server && sudo docker compose up -d Wait 15-30 minutes for the first start, then open http://localhost:3334 in a browser
Where can I get obico-server?
The source code and installation instructions are on GitHub: https://github.com/TheSpaghettiDetective/obico-server

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects