{"id":35387564,"url":"https://github.com/imagegenius/docker-obico","last_synced_at":"2026-02-27T08:16:10.588Z","repository":{"id":65265955,"uuid":"585003604","full_name":"imagegenius/docker-obico","owner":"imagegenius","description":"Monolithic (Single) Docker Container for Obico Server","archived":false,"fork":false,"pushed_at":"2026-02-20T05:04:30.000Z","size":403,"stargazers_count":12,"open_issues_count":7,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-20T08:38:47.839Z","etag":null,"topics":["docker","minimal","monolithic","obico"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/imagegenius/obico","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imagegenius.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-01-04T04:14:20.000Z","updated_at":"2026-02-20T04:46:20.000Z","dependencies_parsed_at":"2023-02-15T21:45:52.227Z","dependency_job_id":"2330efe8-47ec-427c-8397-c73d2499bb3d","html_url":"https://github.com/imagegenius/docker-obico","commit_stats":null,"previous_names":[],"tags_count":253,"template":false,"template_full_name":null,"purl":"pkg:github/imagegenius/docker-obico","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagegenius%2Fdocker-obico","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagegenius%2Fdocker-obico/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagegenius%2Fdocker-obico/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagegenius%2Fdocker-obico/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imagegenius","download_url":"https://codeload.github.com/imagegenius/docker-obico/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imagegenius%2Fdocker-obico/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29888151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T07:54:54.515Z","status":"ssl_error","status_checked_at":"2026-02-27T07:54:49.177Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","minimal","monolithic","obico"],"created_at":"2026-01-02T07:31:17.828Z","updated_at":"2026-02-27T08:16:10.557Z","avatar_url":"https://github.com/imagegenius.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- DO NOT EDIT THIS FILE MANUALLY --\u003e\n\u003c!-- Please read https://github.com/imagegenius/docker-obico/blob/main/.github/CONTRIBUTING.md --\u003e\n\n# [imagegenius/obico](https://github.com/imagegenius/docker-obico)\n\n[![GitHub Release](https://img.shields.io/github/release/imagegenius/docker-obico.svg?color=007EC6\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026logo=github)](https://github.com/imagegenius/docker-obico/releases)\n[![GitHub Package Repository](https://shields.io/badge/GitHub%20Package-blue?logo=github\u0026logoColor=ffffff\u0026style=for-the-badge)](https://github.com/imagegenius/docker-obico/packages)\n[![Jenkins Build](https://img.shields.io/jenkins/build?labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026jobUrl=https%3A%2F%2Fci.imagegenius.io%2Fjob%2FDocker-Pipeline-Builders%2Fjob%2Fdocker-obico%2Fjob%2Fmain%2F\u0026logo=jenkins)](https://ci.imagegenius.io/job/Docker-Pipeline-Builders/job/docker-obico/job/main/)\n[![IG CI](https://img.shields.io/badge/dynamic/yaml?color=007EC6\u0026labelColor=555555\u0026logoColor=ffffff\u0026style=for-the-badge\u0026label=CI\u0026query=CI\u0026url=https%3A%2F%2Fci-tests.imagegenius.io%2Fobico%2Flatest-main%2Fci-status.yml)](https://ci-tests.imagegenius.io/obico/latest-main/index.html)\n\nObico is a community-built, open-source smart 3D printing platform used by makers, enthusiasts, and tinkerers around the world.\n\n[![obico](https://www.obico.io/wwwimg/logo.svg)](https://www.obico.io/)\n\n## Supported Architectures\n\nWe use Docker manifest for cross-platform compatibility. More details can be found on [Docker's website](https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list).\n\nTo obtain the appropriate image for your architecture, simply pull `ghcr.io/imagegenius/obico:latest`. Alternatively, you can also obtain specific architecture images by using tags.\n\nThis image supports the following architectures:\n\n| Architecture | Available | Tag |\n| :----: | :----: | ---- |\n| x86-64 | ✅ | amd64-\\\u003cversion tag\\\u003e |\n| arm64 | ❌ | |\n| armhf | ❌ | |\n\n## Version Tags\n\nThis image offers different versions via tags. Be cautious when using unstable or development tags, and read their descriptions carefully.\n\n| Tag | Available | Description |\n| :----: | :----: |--- |\n| latest | ✅ | Latest obico-server release, only supports CPU for machine learning. |\n| cuda | ✅ | Latest obico-server release with support for GPU (CUDA) acceleration. |\n\n## Application Setup\n\nThe WebUI can be found at `http://your-ip:3334`.\n\n**After starting the container, it is important to configure obico-server (Django) to ensure that all assets are properly loaded. \n\nFollow steps 1-2 under 'Login as Django admin' and 'Configure Django site' in the [Obico Server Configuration](https://www.obico.io/docs/server-guides/configure/#login-as-django-admin) guide closely. These steps will guide you through setting up login credentials and configuring the domain name to match the IP used to access the container, or your FQDN if using a reverse proxy.\n\nYou can also use environment variables to set various configurations, such as email settings. A list of available environment variables can be found [here](https://github.com/TheSpaghettiDetective/obico-server/blob/release/docker-compose.yml#L13-L40).\n\nObico requires that you have Redis setup externally.\n\nFollow these steps if you need help setting up Redis.\n\n#### Redis:\n\nRedis can be ran within the container using a docker-mod or you can use an external Redis server/container.\n\nIf you don't need to use Redis elsewhere add this environment variable: `DOCKER_MODS=imagegenius/mods:universal-redis`, and set `REDIS_URL` to `redis://localhost:6379`.\n\nOr within a seperate container:\n\n```bash\ndocker run -d \\\n  --name=redis \\\n  -p 6379:6379 \\\n  redis\n```\n\nObico do not publish versioning for obico-server, so we use the latest commit hash to identify the current version.\n\n## Usage\n\nExample snippets to start creating a container:\n\n### Docker Compose\n\n```yaml\n---\nservices:\n  obico:\n    image: ghcr.io/imagegenius/obico:latest\n    container_name: obico\n    environment:\n      - PUID=1000\n      - PGID=1000\n      - TZ=Etc/UTC\n      - REDIS_URL=redis://\u003cip\u003e:\u003cport\u003e\n      - HOST_IP=\u003c192.168.0.5:3334\u003e/\u003cexample.com\u003e\n    volumes:\n      - path_to_appdata:/config\n    ports:\n      - 3334:3334\n    restart: unless-stopped\n```\n\n### Docker CLI ([Click here for more info](https://docs.docker.com/engine/reference/commandline/cli/))\n\n```bash\ndocker run -d \\\n  --name=obico \\\n  -e PUID=1000 \\\n  -e PGID=1000 \\\n  -e TZ=Etc/UTC \\\n  -e REDIS_URL=redis://\u003cip\u003e:\u003cport\u003e \\\n  -e HOST_IP=\u003c192.168.0.5:3334\u003e/\u003cexample.com\u003e \\\n  -p 3334:3334 \\\n  -v path_to_appdata:/config \\\n  --restart unless-stopped \\\n  ghcr.io/imagegenius/obico:latest\n```\n\n## Parameters\n\nTo configure the container, pass variables at runtime using the format `\u003cexternal\u003e:\u003cinternal\u003e`. For instance, `-p 8080:80` exposes port `80` inside the container, making it accessible outside the container via the host's IP on port `8080`.\n\n| Parameter | Function |\n| :----: | --- |\n| `-p 3334` | WebUI Port |\n| `-e PUID=1000` | UID for permissions - see below for explanation |\n| `-e PGID=1000` | GID for permissions - see below for explanation |\n| `-e TZ=Etc/UTC` | Specify a timezone to use, see this [list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). |\n| `-e REDIS_URL=redis://\u003cip\u003e:\u003cport\u003e` | Redis URL, eg. `redis://192.168.1.2:6379` |\n| `-e HOST_IP=\u003c192.168.0.5:3334\u003e/\u003cexample.com\u003e` | Domain/IP+Port used to access the frontend, if incorrect you will get an error 500! |\n| `-v /config` | Contains django database, logs and timelapses |\n\n## Umask for running applications\n\nAll of our images allow overriding the default umask setting for services started within the containers using the optional -e UMASK=022 option. Note that umask works differently than chmod and subtracts permissions based on its value, not adding. For more information, please refer to the Wikipedia article on umask [here](https://en.wikipedia.org/wiki/Umask).\n\n## User / Group Identifiers\n\nTo avoid permissions issues when using volumes (`-v` flags) between the host OS and the container, you can specify the user (`PUID`) and group (`PGID`). Make sure that the volume directories on the host are owned by the same user you specify, and the issues will disappear.\n\nExample: `PUID=1000` and `PGID=1000`. To find your PUID and PGID, run `id user`.\n\n```bash\n  $ id username\n    uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)\n```\n\n\n## Updating the Container\n\nMost of our images are static, versioned, and require an image update and container recreation to update the app. We do not recommend or support updating apps inside the container. Check the [Application Setup](#application-setup) section for recommendations for the specific image.\n\nInstructions for updating containers:\n\n### Via Docker Compose\n\n* Update all images: `docker-compose pull`\n  * or update a single image: `docker-compose pull obico`\n* Let compose update all containers as necessary: `docker-compose up -d`\n  * or update a single container: `docker-compose up -d obico`\n* You can also remove the old dangling images: `docker image prune`\n\n### Via Docker Run\n\n* Update the image: `docker pull ghcr.io/imagegenius/obico:latest`\n* Stop the running container: `docker stop obico`\n* Delete the container: `docker rm obico`\n* Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)\n* You can also remove the old dangling images: `docker image prune`\n\n## Versions\n\n* **09.01.25:** - improve HOST_IP instructions\n* **29.09.23:** - precompile darknet\n* **29.06.23:** - create seperate cuda branch\n* **23.03.23:** - add service checks\n* **05.03.23:** - rollback moonraker (breaking upstream update)\n* **23.01.23:** - BREAKING: removed redis\n* **14.01.23:** - Update to s6v3\n* **05.01.23:** - Initial Working Release.\n* **04.01.23:** - Initial Release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagegenius%2Fdocker-obico","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimagegenius%2Fdocker-obico","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimagegenius%2Fdocker-obico/lists"}