在已安装docker engine和compose插件的linux测试服务器上，可使用firefly iii官方compose文件启动应用、mariadb和cron三个服务。安装前应同步修改应用与数据库密码，设置独立的32字符app_key和static_cron_token，确认数据库卷及上传卷持久化，再启动并检查服务。
准备官方文件
mkdir firefly-iii cd firefly-iii curl -fL https://raw.githubusercontent.com/firefly-iii/docker/main/docker-compose.yml -o docker-compose.yml curl -fL https://raw.githubusercontent.com/firefly-iii/docker/main/database.env -o .db.env curl -fL https://raw.githubusercontent.com/firefly-iii/firefly-iii/main/.env.example -o .env
官方Compose使用fireflyiii/core:latest与mariadb:lts。latest指向稳定版，但不是固定不变的版本号；准备长期使用时应记录实际拉取版本，并按官方标签规则固定所需版本。数据库镜像和应用镜像还须同时支持服务器架构。
Firefly III官方Compose文件中的应用与数据库服务
匹配数据库与应用设置
在.db.env中设置MYSQL_DATABASE=firefly、MYSQL_USER=firefly，并把MYSQL_PASSWORD换成独立密码；.env中的DB_CONNECTION=mysql、DB_HOST=db、DB_PORT=3306、DB_DATABASE=firefly、DB_USERNAME=firefly与DB_PASSWORD须与之对应。不要将示例中的secret_firefly_password直接用于实际服务。
APP_KEY和STATIC_CRON_TOKEN各设置一个独立的32字符值，可分别使用openssl rand -hex 16生成；保存好APP_KEY，后续不要随意重建。设置SITE_OWNER为自己的邮箱、TZ为所需时区，并将APP_URL改成实际访问地址。
chmod 600 .env .db.env docker compose config -q
官方示例将主机80端口映射到应用8080端口。如果80已被占用，可改为127.0.0.1:8088:8080，再通过服务器本地8088端口或已有反向代理访问。外部开放服务时，域名、HTTPS和代理转发需按真实环境配置。
Firefly III官方环境变量文件中的应用基础设置
启动并核对三项持久状态
docker compose pull docker compose up -d docker compose ps docker compose logs --tail=50 app db cron
应用服务使用firefly_iii_upload卷保存上传文件，数据库服务使用firefly_iii_db卷保存MariaDB数据。保留卷不等于已建立备份；更新前仍需安排数据库与上传数据的可恢复备份，也不要使用down -v当成普通重启命令。
cron服务从.env读取时区及STATIC_CRON_TOKEN，官方配置每天3点请求应用内部cron接口。服务刚启动时还没到计划时间，不能据此报告定时任务已经执行成功；结合其日志和应用中的定时任务结果核对。最后通过配置的访问地址创建账户，并检查数据库写入和页面访问，再考虑作为长期实例使用。
