Containerized Deployments

Deploy OpenSOHO using Docker, Podman, or Kubernetes.

Docker / Podman

Prebuilt OpenSOHO container images are available at github.com/orgs/opensoho/packages.

A custom container image can be built using the Dockerfile in the repository.

Docker Compose

opensoho:
  image: ghcr.io/opensoho/opensoho:latest
  container_name: opensoho
  command: serve --http 0.0.0.0:8090
  environment:
    - OPENSOHO_SHARED_SECRET=LoNgExAmPleStrInGoF32cHarActeRs5
  volumes:
    - "./opensoho/pb_data:/ko-app/pb_data"
  ports:
    - 8090:8090
  restart: unless-stopped

Mounting a volume to /ko-app/pb_data preserves your configuration and history across upgrades. Copy the contents of the pb_data directory when migrating.

Initial Setup Note: When starting the application for the first time, look at the startup logfiles. You will find an automatically generated “create user” link printed there. Use this link in your browser to set up your initial admin username and password.

Kubernetes

A Helm chart is available, provided by the community.

It can be found here.