Firefly III

# Connect via SSH
ssh root@your-vps-ip

# Alternative with key file
ssh -i /path/to/key root@your-vps-ip

# Create and navigate to project directory
mkdir -p ~/apps/firefly-iii
cd ~/apps/firefly-iii

services:
  app:
    image: fireflyiii/core:latest
    ports:
      - "8080:8080"
    environment:
      - APP_KEY=<your-app-key>
      - APP_URL=http://localhost:8080
      - DB_CONNECTION=mysql
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=firefly
      - DB_USERNAME=firefly
      - DB_PASSWORD=<your-db-password>
      - [email protected]
      - TZ=UTC
      - STATIC_CRON_TOKEN=<your-cron-token>
    volumes:
      - firefly_upload:/var/www/html/storage/upload
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy

  db:
    image: mariadb:lts
    environment:
      - MYSQL_RANDOM_ROOT_PASSWORD=yes
      - MYSQL_USER=firefly
      - MYSQL_PASSWORD=<your-db-password>
      - MYSQL_DATABASE=firefly
    volumes:
      - firefly_db:/var/lib/mysql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -p$$MYSQL_ROOT_PASSWORD || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

  cron:
    image: alpine:latest
    command: >
      sh -c "echo '0 3 * * * wget -qO- http://app:8080/api/v1/cron/<your-cron-token>' | crontab - && crond -f -L /dev/stdout"
    restart: unless-stopped
    depends_on:
      - app

volumes:
  firefly_upload:
  firefly_db:

# Start all services
docker compose up -d

# List running containers
docker compose ps

# Watch the logs
docker compose logs -f

# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8080