[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-8847":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},8847,"obico-server","TheSpaghettiDetective\u002Fobico-server","TheSpaghettiDetective","Obico is a community-built, open-source smart 3D printing platform used by makers, enthusiasts, and tinkerers around the world.","https:\u002F\u002Fobico.io",null,"Vue",1846,350,36,103,0,1,5,29,4,20.64,"GNU Affero General Public License v3.0",false,"release",true,[],"2026-06-12 02:01:59","# The Obico Server\n\nThis repo is everything you need to run a self-hosted Obico Server.\n\n[Obico](https:\u002F\u002Fwww.obico.io) is a community-built, open-source smart 3D printing platform used by makers, enthusiasts, and tinkerers around the world.\n\nThe AI failure detection in this project is based on a Deep Learning model. [See how the model works on real data](https:\u002F\u002Fapp.obico.io\u002Fent_pub\u002Fpublictimelapses\u002F).\n\n> **Note:** If you are looking for information about setting up self-hosted server for [JusPrin](https:\u002F\u002Fgithub.com\u002FTheSpaghettiDetective\u002FJusPrin), please see [README_jusprin_server.md](README_jusprin_server.md) for specific instructions.\n\n# Install and run the server\n\n> **Note:** For more detailed instructions, head to [the Obico Server guide](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002F).*\n\n## Prerequisites\n\nThe Obico Server only requires a computer to run. Even old PCs (within the previous 10 years) will do just fine. An Nvidia GPU is optional but can vastly increase the power consumption and beef up the number of printers the server can handle.\n\n[Detailed hardware minimum specs](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fhardware-requirements\u002F).\n\n### Software requirements\n\nThe following software is required before you start installing the server:\n\n- Docker and Docker-compose. But you don't have to understand how Docker or Docker-compose works.\n    - Install Docker ([Windows](https:\u002F\u002Fdocs.docker.com\u002Fdocker-for-windows\u002Finstall\u002F), [Ubuntu](https:\u002F\u002Fdocs.docker.com\u002Finstall\u002Flinux\u002Fdocker-ce\u002Fubuntu\u002F), [Fedora](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall\u002Ffedora\u002F), [CentOS](https:\u002F\u002Fdocs.docker.com\u002Fengine\u002Finstall\u002Fcentos\u002F), [Mac](https:\u002F\u002Fdocs.docker.com\u002Fdocker-for-mac\u002Finstall\u002F)). **Important:** If your server has an old Docker version, please follow the instructions in these links to upgrade to the latest version, otherwise you may run into all kinds of weird problems.\n    - [Install Docker-compose](https:\u002F\u002Fdocs.docker.com\u002Fcompose\u002Finstall\u002F). You need Docker-compose V2.0 or higher.\n- git ([how to install](https:\u002F\u002Fgit-scm.com\u002Fdownloads)).\n\n### Email delivery\n\nYou will also need an email account that has SMTP access enabled (gmail will not work. As of May 30, 2022 Google has removed the option for allowing SMTP access). Other web mail such as Yahoo should work but we haven't tried them.\n\n## Get the code and start the server\n\n1. Get the code:\n\n```\ngit clone -b release https:\u002F\u002Fgithub.com\u002FTheSpaghettiDetective\u002Fobico-server.git\n```\n\n2. Run it! Do **either** one of these based on what OS you are using:\n    - If you are on Linux: `cd obico-server && sudo docker compose up -d`\n    - If you are on Mac: `cd obico-server && docker-compose up -d`\n    - If you are on Windows: `cd obico-server; docker-compose up -d`\n\n3. Go grab a coffee. Step 2 will take 15-30 minutes.\n\n4. If the Obico Server is running on `localhost`, there will be no step 4. If it is running on a different host, such as a VM in the cloud, go ahead to [configure the Django site](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fconfigure\u002F#django-site).\n\nOpen \"http:\u002F\u002Flocalhost:3334\" on the same computer. Voila - your self-hosted Obico Server is now up and running!\n\n![Login page](website\u002Fstatic\u002Fimg\u002Fserver-guides\u002Flogin-page.png)\n\n# Server Configuration\n\nUpon fresh installation, the Obico Server can only work on the localhost. You will need to configure its IP address. Here is how:\n\n## Obtain server's IP address\n\n[Recommended Read: Connecting to your server with a .local address](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fconfigure\u002F)\n\nThis refers to the LAN IP address that has been given to the computer that the Obico server is running on.\n- If you are on Linux: Open the wifi settings and select \"settings\" for the network your device is currently connected to. Look for the IPv4 value.\n- If you are on Windows: Select \"Properties\" for the network your device is connected to, then look for the IPv4 value.\n- If you are on Mac: Go to Settings > Network. You will find your IPv4 value below the wifi status.\n\nThe Obico Server needs to have an IP address that is accessible by OctoPrint or Klipper. It can be a private IP address (192.168.x.y, etc) but there needs to be a route between OctoPrint and the Obico Server.\n\nIt is also recommended that a static IP is set to avoid issues with changing IP's. Please look up your WiFi routers guide on how to do this.\n\n## Login as Django admin\n\n1. Open Django admin page at `http:\u002F\u002Fyour_server_ip:3334\u002Fadmin\u002F`.\n\n> **Note:** If the browser complains \"Can't connect to the server\", wait for a couple more minutes. The web server container may still be starting up.*\n\n2. Login with username `root@example.com`, password `supersecret`. Once logged in, you can optionally (but are highly encouraged to) change the admin password using this link: `http:\u002F\u002Fyour_server_ip:3334\u002Fadmin\u002Fapp\u002Fuser\u002F1\u002Fpassword\u002F`.\n\n## Configure Django site\n\n1. In the same browser window, go to the address `http:\u002F\u002Fyour_server_ip:3334\u002Fadmin\u002Fsites\u002Fsite\u002F1\u002Fchange\u002F`. Change \"Domain name\" to `your_server_ip:3334`. No \"http:\u002F\u002F\", \"https:\u002F\u002F\" prefix or trailing \"\u002F\", otherwise it will NOT work. *Note: Deleting the original site and adding a new one won't work, thanks to the quirkiness of Django site.*\n\n2. Click \"Save\". Yes it's correct that Django is not as smart as most people think. ;)\n\n![Site configuration](website\u002Fstatic\u002Fimg\u002Fserver-guides\u002Fsite_config.png)\n\n> **Note:** If you are using reverse proxy, \"Domain name\" needs to be set to `reverse_proxy_ip:reverse_proxy_port`. See [using a reverse proxy](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fadvanced\u002Freverse-proxy\u002F) for details.*\n\nThat's it! You now have a fully-functional Obico Server that your OctoPrint can talk to. We hope setting up the server has not been overwhelming.\n\n# Configure clients to use self-hosted Obico Server\n\n- [Obico for OctoPrint plugin](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fconfigure-octoprint-plugin\u002F).\n- [Obico mobile app](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002Fconfigure-mobile-app).\n\n# Contribute to Obico\n\nFeeling excited? Want to contribute? [Check out how.](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fdeveloper-guides\u002Fcontribute\u002F)\n\n# Difficulties in getting the Obico server up and running?\n\nBrowse and search in the [Obico Server guide website](https:\u002F\u002Fwww.obico.io\u002Fdocs\u002Fserver-guides\u002F). If you can't find the answer there, consult the [Discord](https:\u002F\u002Fobico.io\u002Fdiscord) or [open an issue](https:\u002F\u002Fgithub.com\u002FTheSpaghettiDetective\u002Fobico-server\u002Fissues\u002Fnew).\n\n# Thanks\n![BrowserStack](docs\u002Fimg\u002Fbrowserstack.png \"BrowserStack\") [BrowserStack](https:\u002F\u002Fwww.browserstack.com\u002F) generously sponsors a free license so that I can test Obico webcam streaming on different browsers\u002Fversions.\n[Moonraker](https:\u002F\u002Fgithub.com\u002FArksine\u002Fmoonraker) for the source code to extract g-code metadata.\n","Obico 是一个由社区构建的开源智能3D打印平台，服务于全球的制作者、爱好者和技术爱好者。其核心功能包括基于深度学习模型的AI故障检测，能够实时监控并识别打印过程中的问题。该平台支持自托管部署，仅需一台电脑即可运行，甚至10年内的旧PC也能胜任，可选配Nvidia GPU以提升处理能力。适合于需要远程管理和监控3D打印机的工作室或个人用户使用，通过简单的Docker和git安装步骤即可快速搭建服务环境。",2,"2026-06-11 03:19:59","top_language"]