Skip to main content

OCS Inventory on Docker

Spin up OCS Inventory 3.0 — the Django REST API, the Vue single-page UI and PostgreSQL — as a clean, secure, upgrade-friendly stack behind a single hostname.

OCS Inventory 3.0 License GPL-3.0 Images on GHCR amd64 · arm64

# Prebuilt images from GHCR — deploy in two commands
docker compose pull && docker compose up -d

🚀 Get started    How it works

Where to begin

First time here? Head to Getting started — you'll have OCS running in a few commands. Already deployed? Pick a card below.

Highlights​

  • 🔒 Production-ready — non-root, slim multi-stage images; gunicorn + WhiteNoise behind an nginx TLS edge; healthchecks; logs to stdout.
  • ⬆️ Upgrade-safe — built from pinned upstream tags; migrations run idempotently before the app starts; your data and SECRET_KEY survive every update.
  • 🎛️ Runtime-configurable — UI & API base paths, public ports and the backend URL are chosen at container start — no image rebuild.
  • 🌐 Single hostname — UI under /front/, API and agents under /api/, same origin (no CORS to wrangle, configurable).
  • 🧬 Multi-version — one set of parameterized Dockerfiles plus a versions.json manifest; CI builds every OCS release for amd64 & arm64.

Explore the docs​

🚀 Getting started

Prerequisites, configuration, TLS certificates, and your first login.

🏗️ Architecture

Services, request flow, URL mapping, and startup order.

⚙️ Configuration

Every environment variable, base paths, TLS, and the Django overlay.

🛠️ Operations

Upgrade, admin & SSO, OCS agents, backups, logs and troubleshooting.

🧑‍💻 Developer docs

Project layout, source patches, publishing a version, and CI/CD.