docker pull ghcr.io/lowercasename/gathio:1.6.7
1.6.7: Pulling from lowercasename/gathio
Digest: sha256:f061733f5688363d1316d76d2b6700cafc4d1936bd67e4d34809a01ef2ee18df
Status: Image is up to date for ghcr.io/lowercasename/gathio:1.6.7

docker --version
Docker version 29.9.2, build a82e528

docker compose version
Docker Compose version v5.6.1

ss -lnt | grep 8153
# 无输出即空闲

mkdir -p /opt/gathio/config /opt/gathio/static /opt/gathio/images
cd /opt/gathio

docker run --rm ghcr.io/lowercasename/gathio:1.6.7 cat /app/config/config.example.toml > /opt/gathio/config/config.toml

[general]
domain = "localhost:8153"
port = "3000"
email = "admin@example.com"
site_name = "Gathio"
is_federated = true
delete_after_days = 7
email_logo_url = ""
show_kofi = false
show_public_event_list = false
max_comment_length = 5000
mail_service = "none"
creator_email_addresses = []

[database]
mongodb_url = "mongodb://mongo:27017/gathio"

[nodemailer]
smtp_server = ""
smtp_port = ""
smtp_username = ""
smtp_password = ""

[sendgrid]
api_key = ""

[mailgun]
domain = ""
api_key = ""
api_url = "https://api.mailgun.net"

[[static_pages]]
title = "Privacy Policy"
path = "/privacy"
filename = "privacy-policy.md"

volumes:
  mongodb_data_db:

services:
  gathio:
    container_name: gathio-app
    image: ghcr.io/lowercasename/gathio:1.6.7
    links:
      - mongo
    environment:
      - NODE_ENV=production
    ports:
      - 8153:3000
    volumes:
      - ./config:/app/config
      - ./static:/app/static
      - ./images:/app/public/events
    restart: unless-stopped
  mongo:
    container_name: gathio-db
    image: mongo:7.0
    volumes:
      - mongodb_data_db:/data/db
    restart: unless-stopped

cd /opt/gathio && docker compose up -d
 Network gathio_default Creating
 Volume gathio_mongodb_data_db Creating
 Volume gathio_mongodb_data_db Created
 Network gathio_default Created
 Container gathio-db Creating
 Container gathio-db Created
 Container gathio-app Creating
 Container gathio-app Created
 Container gathio-db Starting
 Container gathio-db Started
 Container gathio-app Starting
 Container gathio-app Started

docker ps --format '{{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}' | grep gathio
gathio-app   ghcr.io/lowercasename/gathio:1.6.7   Up 6 seconds   0.0.0.0:8153->3000/tcp, [::]:8153->3000/tcp
gathio-db    mongo:7.0                            Up 6 seconds   27017/tcp

docker logs gathio-app
> gathio@1.6.7 start
> node dist/start.js

You have not configured this Gathio instance to send emails! This means that event creators will not receive emails when their events are created, which means they may end up locked out of editing events. Consider setting up an email service.
Welcome to gathio! The app is now running on http://localhost:3000
Mongoose connection open!

curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost:8153/
HTTP 200

curl -s -X POST http://localhost:8153/event \
  --data-urlencode "eventName=Team Retro" \
  --data-urlencode "eventLocation=Office 3F" \
  --data-urlencode "eventStart=2026-11-05T15:00" \
  --data-urlencode "eventEnd=2026-11-05T16:00" \
  --data-urlencode "timezone=Asia/Shanghai" \
  --data-urlencode "eventDescription=Quarterly retro" \
  --data-urlencode "creatorEmail=admin@example.com" \
  --data-urlencode "hostName=Admin" \
  --data-urlencode "joinCheckbox=true" \
  --data-urlencode "interactionCheckbox=true"
{"eventID":"cWI7ePnEPxs4JEK45qvbN","editToken":"3a20dzqt3hrxgrudl1qp0nm2tf0z4lqu","url":"/cWI7ePnEPxs4JEK45qvbN?e=3a20dzqt3hrxgrudl1qp0nm2tf0z4lqu"}

curl -s -o /dev/null -w "GET /cWI7ePnEPxs4JEK45qvbN -> HTTP %{http_code}\n" http://localhost:8153/cWI7ePnEPxs4JEK45qvbN
GET /cWI7ePnEPxs4JEK45qvbN -> HTTP 200

docker inspect gathio-app --format '{{range .Mounts}}{{.Type}} {{.Source}} -> {{.Destination}}{{"\n"}}{{end}}'
bind /opt/gathio/config -> /app/config
bind /opt/gathio/static -> /app/static
bind /opt/gathio/images -> /app/public/events

docker volume ls | grep gathio
local     gathio_mongodb_data_db

# 情形一：compose 中设置 GATHIO_MONGODB_URL=mongodb://mongo:27017/gathio
docker logs gathio-app | tail -1
Mongoose connection open!
curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost:8153/
HTTP 200

# 情形二：删除该环境变量后重启（输出节选，实测首尾）
docker logs gathio-app | tail -6
Config references environment variable "GATHIO_MONGODB_URL" which is not set. The literal string "${GATHIO_MONGODB_URL}" will be used instead.
Connection error: Invalid connection string
MongoParseError: Invalid connection string
    at parseConnectionString (/app/node_modules/.pnpm/mongodb@3.7.4/node_modules/mongodb/lib/core/uri_parser.js:585:21)

docker inspect gathio-app --format 'RestartCount={{.RestartCount}}'
RestartCount=4

printf '# Privacy Policy\n\nEvents self-destruct automatically.\n' > /opt/gathio/static/privacy-policy.md
docker compose restart gathio
curl -s -o /dev/null -w "GET /privacy -> HTTP %{http_code}\n" http://localhost:8153/privacy
GET /privacy -> HTTP 200

docker run -d --name gathio-runtest --network gathio_default -p 8157:3000 \
  -e NODE_ENV=production \
  -v /opt/gathio/config:/app/config \
  -v /opt/gathio/static:/app/static \
  -v /opt/gathio/images-run:/app/public/events \
  ghcr.io/lowercasename/gathio:1.6.7
9e98702bd73154bed5ec8f3c80c4f09fc5b845f7589ec8b044ba0fa2fcd24ee4

curl -s -o /dev/null -w "GET :8157 -> HTTP %{http_code}\n" http://localhost:8157/
GET :8157 -> HTTP 200

docker logs gathio-runtest | tail -2
Welcome to gathio! The app is now running on http://localhost:3000
Mongoose connection open!

# 查看状态
docker compose ps
NAME         IMAGE                                COMMAND                  SERVICE   CREATED          STATUS          PORTS
gathio-app   ghcr.io/lowercasename/gathio:1.6.7   "docker-entrypoint.s…"   gathio    10 minutes ago   Up 10 minutes   0.0.0.0:8153->3000/tcp, [::]:8153->3000/tcp
gathio-db    mongo:7.0                            "docker-entrypoint.s…"   mongo     16 minutes ago   Up 16 minutes   27017/tcp

# 跟踪日志（启动/崩溃定位第一入口）
docker compose logs -f gathio

# 改配置后重启应用
docker compose restart gathio

# 进应用容器排障
docker exec -it gathio-app sh

# 数据库交互式查询
docker exec -it gathio-db mongosh gathio

# 资源占用（空闲基线：app ~100MiB、db ~75MiB）
docker stats --no-stream gathio-app gathio-db
gathio-app   0.00%   100MiB / 15.57GiB
gathio-db    0.27%   74.76MiB / 15.57GiB

# 停止（保留数据）/ 启动
docker compose down
docker compose up -d

Error response from daemon: failed to set up container networking: driver failed programming external connectivity on endpoint gathio-app (89433a7a81d12e9313c6dca1849b56a799e527e646e5db0fb5823c362c372742): Bind for 0.0.0.0:8153 failed: port is already allocated

Configuration file not found! Have you renamed './config/config.example.toml' to './config/config.toml'?

Error parsing configuration: [SyntaxError: Expected "=" or [ \t] but "l" found.]

docker exec gathio-app nc -zv mongo 27017
mongo (172.24.0.2:27017) open