$ curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" http://192.168.146.128:8130/api/v1/about
{"data":{"version":"6.7.9","api_version":"6.7.9","php_version":"8.5.12","os":"Linux","driver":"pgsql"}}
$ docker exec firefly-iii-6.7.9-importer php artisan importer:version
Firefly III data importer v2.3.5
PHP: cli 8.5.12 Linux

$ docker compose version
Docker Compose version v5.6.1
$ docker --version
Docker version 29.9.2, build a82e528

mkdir -p /opt/firefly-iii/data/upload && cd /opt/firefly-iii

$ head /dev/urandom | LC_ALL=C tr -dc 'A-Za-z0-9' | head -c 32 && echo
CqRn77wKahWp5Bsnwogd4wbgBrXKU9Rw
$ head /dev/urandom | LC_ALL=C tr -dc 'A-Za-z0-9' | head -c 32 && echo
msiPUbX4gIqx9L1gAkwUmrfgJqYRmGzS

APP_ENV=production
APP_DEBUG=false
SITE_OWNER=admin@firefly.local
APP_KEY=CqRn77wKahWp5Bsnwogd4wbgBrXKU9Rw
APP_URL=http://192.168.146.128:8130
DEFAULT_LANGUAGE=en_US
DEFAULT_LOCALE=equal
TZ=Asia/Shanghai
TRUSTED_PROXIES=
LOG_CHANNEL=stack
APP_LOG_LEVEL=notice
AUDIT_LOG_LEVEL=emergency
AUDIT_LOG_CHANNEL=
DB_CONNECTION=pgsql
DB_HOST=db
DB_PORT=5432
DB_DATABASE=firefly
DB_USERNAME=firefly
DB_PASSWORD=q1w2e3r4
PGSQL_SCHEMA=public
CACHE_STORE=file
SESSION_DRIVER=file
STATIC_CRON_TOKEN=msiPUbX4gIqx9L1gAkwUmrfgJqYRmGzS
MAIL_MAILER=log
MAIL_FROM=changeme@example.com
COOKIE_SECURE=false
COOKIE_SAMESITE=lax

name: firefly-iii-6.7.9-stack

services:
  app:
    image: fireflyiii/core:latest
    hostname: app
    container_name: firefly-iii-6.7.9-app
    restart: unless-stopped
    depends_on:
      - db
    ports:
      - "8130:8080"
    env_file: .env
    volumes:
      - ./data/upload:/var/www/html/storage/upload

  db:
    image: postgres:16-alpine
    hostname: db
    container_name: firefly-iii-6.7.9-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: firefly
      POSTGRES_PASSWORD: q1w2e3r4
      POSTGRES_DB: firefly
      TZ: Asia/Shanghai
    volumes:
      - firefly_iii_db:/var/lib/postgresql/data

  cron:
    image: alpine
    restart: unless-stopped
    container_name: firefly-iii-6.7.9-cron
    env_file: .env
    command: ["sh", "-c", "apk add tzdata >/dev/null 2>&1 && \
      (ln -s /usr/share/zoneinfo/$$TZ /etc/localtime || true) && \
      echo \"0 3 * * * wget -qO- http://app:8080/api/v1/cron/$$STATIC_CRON_TOKEN;echo\" \
      | crontab - && \
      crond -f -L /dev/stdout"]
    depends_on:
      - app

  importer:
    image: fireflyiii/data-importer:latest
    hostname: importer
    container_name: firefly-iii-6.7.9-importer
    restart: unless-stopped
    depends_on:
      - app
    ports:
      - "8133:8080"
    environment:
      FIREFLY_III_URL: http://app:8080
      TZ: Asia/Shanghai

volumes:
  firefly_iii_db:

networks:
  default:
    driver: bridge
    ipam:
      config:
        - subnet: 10.89.57.0/24

cd /opt/firefly-iii && docker compose up -d

$ docker compose logs -f app
  [i] Wait for the database. You may see an error about an 'aborted connection', this is normal.
wait-for-it.sh: waiting 60 seconds for db:5432
wait-for-it.sh: db:5432 is available after 1 seconds
  [✓] DB is up.
  [i] Will run database commands.
  [i] CreateDB does not apply to "pgsql", skipped.
  [i] Will run upgrade commands.
  [✓] Connected to the database.

   INFO  Preparing database.

  Creating migration table ....................................... 8.25ms DONE

   INFO  Running migrations.
（迁移输出节选——数十条表创建记录）
  [11:11:47] Command firefly-iii:report-integrity took 0.0040 seconds.
  [11:11:47] Command firefly-iii:correct-database took 0.5900 seconds.
  [i] Encryption keys exist already.
  [i] Updated version.
  [✓] No security alerts for version 6.7.9

+------------------------------------------------------------------------------+
| Thank you for installing Firefly III, v6.7.9!                                |
| There are no extra installation instructions.                                |
| Firefly III should be ready for use.                                         |
+------------------------------------------------------------------------------+
[28-Oct-2026 11:11:49] NOTICE: fpm is running, pid 210
[28-Oct-2026 11:11:49] NOTICE: ready to handle connections
✅ NGINX + PHP-FPM is running correctly.

$ docker compose ps
NAME                        IMAGE                             STATUS                  PORTS
firefly-iii-6.7.9-app       fireflyiii/core:latest            Up 2 minutes (healthy)  0.0.0.0:8130->8080/tcp
firefly-iii-6.7.9-cron      alpine                            Up 2 minutes
firefly-iii-6.7.9-db        postgres:16-alpine                Up 2 minutes            5432/tcp
firefly-iii-6.7.9-importer  fireflyiii/data-importer:latest   Up 2 minutes (healthy)  0.0.0.0:8133->8080/tcp

$ curl -sI http://192.168.146.128:8130/ | head -6
HTTP/1.1 302 Found
Server: nginx
Content-Type: text/html; charset=utf-8
Connection: keep-alive
Cache-Control: no-cache, private
Date: Wed, 28 Oct 2026 03:12:34 GMT

$ docker exec firefly-iii-6.7.9-db psql -U firefly -c "select a.id, a.name, t.type from accounts a join account_types t on a.account_type_id = t.id order by a.id limit 15;"
 id |                      name                       |          type
----+-------------------------------------------------+-------------------------
  1 | Demo Bank                                       | Asset account
  2 | Initial balance for "Demo Bank"                 | Initial balance account
  3 | Demo Bank savings account                       | Asset account
  4 | Initial balance for "Demo Bank savings account" | Initial balance account
  5 | Cash wallet                                     | Asset account
(5 rows)

$ docker exec firefly-iii-6.7.9-app php artisan passport:client --personal --name='firefly-cli' --no-interaction

   INFO  New client created successfully.

$ curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" http://192.168.146.128:8130/api/v1/about
{"data":{"version":"6.7.9","api_version":"6.7.9","php_version":"8.5.12","os":"Linux","driver":"pgsql"}}

{"name":"data-importer","revoked":false,"redirect_uris":["http://192.168.146.128:8133/client-callback"],
 "grant_types":["authorization_code","refresh_token"],"owner_id":1,
 "id":"01a18085-648d-7025-87cd-92e8dc38cc7f",
 "plainSecret":"VoMN8Grt1x8PG95hWDZppW1xD8BDC03D1Q...（演示值节选）"}

$ docker exec firefly-iii-6.7.9-app ls -ld /var/www/html/storage/upload
drwxr-xr-x 3 www-data www-data 4096 Oct 28 10:53 /var/www/html/storage/upload
$ ls -l /opt/firefly-iii/data/upload
total 8
drwxr-xr-x 3 www-data www-data 4096 Oct 28 10:53 .

docker network create --subnet 10.89.57.0/24 firefly-iii-net
docker volume create firefly_iii_db
docker volume create firefly_iii_upload

docker run -d --name firefly-iii-6.7.9-db \
  --network firefly-iii-net \
  -e POSTGRES_USER=firefly \
  -e POSTGRES_PASSWORD=q1w2e3r4 \
  -e POSTGRES_DB=firefly \
  -v firefly_iii_db:/var/lib/postgresql/data \
  --restart unless-stopped \
  postgres:16-alpine

docker run -d --name firefly-iii-6.7.9-app \
  --network firefly-iii-net \
  -p 8130:8080 \
  -e APP_KEY=CqRn77wKahWp5Bsnwogd4wbgBrXKU9Rw \
  -e APP_URL=http://192.168.146.128:8130 \
  -e DB_CONNECTION=pgsql \
  -e DB_HOST=firefly-iii-6.7.9-db \
  -e DB_PORT=5432 \
  -e DB_DATABASE=firefly \
  -e DB_USERNAME=firefly \
  -e DB_PASSWORD=q1w2e3r4 \
  -v firefly_iii_upload:/var/www/html/storage/upload \
  --restart unless-stopped \
  fireflyiii/core:latest

docker compose ps                  # 四服务状态（含健康检查）
docker compose logs -f app         # 跟踪主程序日志（迁移/启动/错误）
docker compose restart app         # 只重启主程序（改 .env 后必须做）
docker compose up -d               # 增量应用编排变更
docker compose down                # 停止并移除四服务（保留命名卷）
docker compose down -v             # ⚠️ 销毁性：连数据库命名卷一起删除
docker exec firefly-iii-6.7.9-app php artisan firefly-iii:output-version   # 版本

docker exec firefly-iii-6.7.9-app php artisan passport:client --personal --name='firefly-cli' --no-interaction