Technical Administration

Operation, configuration, backup, updates and troubleshooting

Audience: Technical administration

Overview

This part is for everyone who runs the oPBWeb Docker stack: host, containers, configuration files, secrets, backup and updates. You do not need a role in oPBWeb for this work, but you do need access to the Docker host and the project directory.

Run all commands in the project directory on the Docker host. The settings an administrator makes in the user interface (config servers, depot stages, users, object storage cleanup) are described in Functional Administration . The initial setup is covered in Installation .

Chapters

  1. Architecture – services, networks, data flow, object storage layout, worker and jobs, how the manual is served.
  2. Configuration – variables in .env, secrets, TLS and COOKIE_SECURE, ports, time limits, image overrides and settings without an .env variable.
  3. LDAP Sign-in – sign-in via LDAP or Active Directory, mapping groups to roles, CA certificate, troubleshooting.
  4. Operation and Updates – start.sh and stop.sh, containers, logs, health endpoints, updates, versioning, development stack, scheduled tasks.
  5. Backup and Restore – what to back up, commands, order and consistency when restoring.
  6. Troubleshooting – typical symptoms with cause and fix, table of important error messages.
  7. Build and Delivery – images, GitLab CI pipeline, building the manual locally and as PDF.