Four things that broke when we set up 5 opensource apps and cost us a day

Описание и применение

При развертывании пяти открытых приложений в Docker возникли четыре критические ошибки, которые потребовали целый день устранения. Решения включают корректную настройку переменных окружения и монтирование томов.

Задача

Deploying five open‑source apps (Gitea, Wiki.js, HedgeDoc, Etherpad, Mattermost) in Docker containers caused multiple failures that consumed a full day of troubleshooting.

Результат

By applying specific environment variable settings and volume configurations, the team resolved four critical deployment issues, restoring all five applications to stable operation.

Рабочий процесс

• 1. For Wiki.js, mount volume to /wiki/data (exists in image) or delete pre‑existing /data volume before starting.
• 2. For HedgeDoc, set only CMD_DB_URL and omit DATABASE_URL when starting the container.
• 3. For Gitea, set GITEA__server__ROOT_URL and GITEA__server__DOMAIN env vars before first start; use four underscores for top‑level settings like GITEA____APP_NAME.
• 4. For Mattermost, create teams via API with "type": "O" to enable invite links; test links in private windows and account for login proxies.

Доказательства

The container starts, the health check is happy, and the log says this ten times before it gives up: ... SQLITE_CANTOPEN

Источник

If you give HedgeDoc a DATABASE_URL variable, even with CMD_DB_URL set as well, it dies at once: ... Cannot read properties of undefined (reading 'dbURL')

Источник

On first start, Gitea shows its install page with everything pre-filled, including "Gitea Website URL". It guesses that from whatever address the first request came in on.

Источник

Invite people, Copy invite link, send it, and the new person gets: "This invite link is invalid"

Источник