LibrePortal/containers/owncloud/owncloud.config
librelad 6813621fe9 config: enable multiple instances everywhere it is actually possible
Three apps were instanceable and the rest were silent, so the feature
looked far narrower than it is. Every app has now been checked against
the two rules instance_create.sh enforces, and the answer recorded in
its config rather than left unset.

32 apps are instance-safe and now say so. Six are not, and each says why
in its own words instead of being indistinguishable from an app nobody
had reviewed:

  pihole      a DNS server must own port 53
  unbound     a resolver must own its fixed 5335
  stalwart    a mail server must own 25/465/587/993
  traefik     must own 443, and one Traefik routes every other app
  prometheus  node-exporter and cadvisor carry no "prometheus" prefix
  stoat       pins 7881, and database/redis/rabbit/minio carry no prefix

The first four are genuinely one-per-host: the port is not arbitrary, it
is the protocol. The last two are compose-identity problems and could be
fixed by prefixing those service names, which is a change to make
deliberately rather than in passing.

Recorded as an explicit false with a reason, not left unset, so the next
person reads a decision instead of an absence. The audit was verified not
to pass anything vacuously: every app resolves at least one service name,
so no app reached "eligible" merely because nothing was found to check.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 23:38:34 +01:00

91 lines
4.8 KiB
Plaintext
Executable File

#
# =============================================================================
# GENERAL CONFIGURATION
# =============================================================================
# APP_NAME = name of application for use in scripts
# COMPOSE_FILE = default for no app_name in the docker-compose file name, app if there is
# BACKUP = if true, include this application in backup operations
# UPDATE_TYPE = auto: new image builds are applied automatically (a recovery snapshot is taken first), manual: only when you press Update
# HEALTHCHECK = if true, default docker health checks for that container will be enabled
# AUTHELIA = if true, use Authelia authentication, if false turned off.
# HEADSCALE = options : false, local, remote (see general config). e.g false or local,remote
#
CFG_OWNCLOUD_APP_NAME=owncloud
# MULTI_INSTANCE = if true, this app can run as multiple isolated instances
# (own data/DB/subdomain/backups) via `libreportal instance create`. Only set on
# apps whose compose identity (container_name, Traefik routers, backup labels)
# is instance-safe — see scripts/instance/instance_create.sh.
CFG_OWNCLOUD_MULTI_INSTANCE=true
CFG_OWNCLOUD_BACKUP=true
CFG_OWNCLOUD_BACKUP_STRATEGY=auto
CFG_OWNCLOUD_UPDATE_TYPE=auto
CFG_OWNCLOUD_COMPOSE_FILE=default
CFG_OWNCLOUD_HEALTHCHECK=true
CFG_OWNCLOUD_AUTHELIA=false
CFG_OWNCLOUD_HEADSCALE=false
#
# =============================================================================
# APPLICATION CONFIGURATION
# =============================================================================
# VERSION = specific version of the application to use
# ADMIN_USERNAME = default admin username for the application
# ADMIN_PASSWORD = default admin password (will be generated if set to RANDOMIZEDPASSWORD)
# DB_NAME / DB_USER / DB_PASSWORD = MariaDB schema + app account used by ownCloud
# DB_ROOT_PASSWORD = MariaDB root account; kept separate from DB_PASSWORD so the app user can be rotated without touching root
#
# Every value below feeds the compose via #LIBREPORTAL|OWNCLOUD_<KEY>_TAG| tags.
# They are generated on first install and preserved across reinstalls — which is
# what keeps them in step with the MariaDB volume, and what makes the admin
# credentials shown in the WebUI the ones ownCloud was actually seeded with.
#
CFG_OWNCLOUD_ADMIN_USERNAME_1=RANDOMIZEDUSERNAME1
CFG_OWNCLOUD_ADMIN_PASSWORD_1=RANDOMIZEDPASSWORD1
CFG_OWNCLOUD_DB_NAME_1=RANDOMIZEDUSERNAME2
CFG_OWNCLOUD_DB_USER_1=RANDOMIZEDUSERNAME3
CFG_OWNCLOUD_DB_PASSWORD_1=RANDOMIZEDPASSWORD2
CFG_OWNCLOUD_DB_ROOT_PASSWORD_1=RANDOMIZEDPASSWORD3
#
# =============================================================================
# METADATA
# =============================================================================
# CATEGORY = application category for grouping
# TITLE = display name for the application
# DESCRIPTION = short description of the application
# LONG_DESCRIPTION = detailed description of the application
# URL = source repository or documentation URL
# ACTIONS = available actions for this application
#
CFG_OWNCLOUD_CATEGORY="storage"
CFG_OWNCLOUD_TITLE="OwnCloud"
CFG_OWNCLOUD_DESCRIPTION="Cloud Storage"
CFG_OWNCLOUD_LONG_DESCRIPTION="ownCloud is a self-hosted file sync and share server that provides secure access to your files from any device"
CFG_OWNCLOUD_URL="https://github.com/owncloud/core"
CFG_OWNCLOUD_ACTIONS="configure|install|restart|shutdown|uninstall"
#
# =============================================================================
# NETWORK CONFIGURATION
# =============================================================================
# DOMAIN = number of domain from the general config, useful when using multiple domains
# HOST NAME = subdomain name e.g test is the name for test.website.com
# WHITELIST = if true only allow whitelisted ips on traefik, if false allow all
#
CFG_OWNCLOUD_DOMAIN=1
CFG_OWNCLOUD_WHITELIST=false
CFG_OWNCLOUD_NETWORK=default
#
# =============================================================================
# PORT CONFIGURATION
# =============================================================================
# PORT_ = port configuration: app|name|external:internal|access|protocol|login|traefik|webui|description
# - app: application name
# - name: service identifier (webui, dns, ssh, etc.)
# - external:internal: port mapping (external can be 'random' for auto-allocation)
# - access: 'public' (internet accessible), 'private' (local network only), 'disabled' (not running)
# - protocol: 'tcp' or 'udp'
# - login: if true, this port requires basic-auth via Traefik (only meaningful when traefik=true)
# - traefik: if true, Traefik handles this port (reverse proxy)
# - webui: if true, this port serves the main web interface
# - description: human-readable description of the service
#
CFG_OWNCLOUD_PORT_1="owncloud-service|webui|random:8080|public|tcp|false|true|true|Web Interface||cloud"