{
  "manifest_version": "1.0.0",
  "template": {
    "id": "0f57064b-e077-40bc-a871-15b97660addb",
    "slug": "firefly-iii",
    "name": "Firefly III | Open-Source Personal Finance Manager",
    "description": "Self Host Firefly III. Personal finance, budgets, multi-currency & more",
    "url": "https://railway.com/deploy/firefly-iii",
    "upstream": {
      "image": "fireflyiii/core:latest"
    }
  },
  "services": [
    {
      "name": "Firefly III",
      "source": {
        "image": "fireflyiii/core:latest"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/www/html/storage/upload",
      "http": true
    },
    {
      "name": "Postgres",
      "source": {
        "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
      },
      "needs_volume": true,
      "volume_mount_path": "/var/lib/postgresql/data",
      "http": false
    }
  ],
  "required_inputs": [
    {
      "key": "TZ",
      "service": "Firefly III",
      "description": "Application timezone",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "PORT",
      "service": "Firefly III",
      "description": "HTTP server listening port",
      "secret": false,
      "strategy": "default",
      "default": "8080"
    },
    {
      "key": "APP_ENV",
      "service": "Firefly III",
      "description": "Application environment mode",
      "secret": false,
      "strategy": "default",
      "default": "production"
    },
    {
      "key": "APP_KEY",
      "service": "Firefly III",
      "description": "32-char encryption key for sessions",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "APP_URL",
      "service": "Firefly III",
      "description": "Public-facing application URL",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_domain"
    },
    {
      "key": "DB_HOST",
      "service": "Firefly III",
      "description": "PostgreSQL hostname via Railway ref",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DB_PORT",
      "service": "Firefly III",
      "description": "PostgreSQL port via Railway ref",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "APP_DEBUG",
      "service": "Firefly III",
      "description": "Disable debug output in production",
      "secret": false,
      "strategy": "default",
      "default": "false"
    },
    {
      "key": "SITE_OWNER",
      "service": "Firefly III",
      "description": "Admin contact email address",
      "secret": false,
      "strategy": "default",
      "default": "mail@example.com"
    },
    {
      "key": "DB_DATABASE",
      "service": "Firefly III",
      "description": "Database name via Railway ref",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DB_PASSWORD",
      "service": "Firefly III",
      "description": "Database password via Railway ref",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "DB_USERNAME",
      "service": "Firefly III",
      "description": "Database user via Railway ref",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "LOG_CHANNEL",
      "service": "Firefly III",
      "description": "Laravel log output destination",
      "secret": false,
      "strategy": "default",
      "default": "stack"
    },
    {
      "key": "MAIL_MAILER",
      "service": "Firefly III",
      "description": "Mail driver (log = no email)",
      "secret": false,
      "strategy": "default",
      "default": "log"
    },
    {
      "key": "CACHE_DRIVER",
      "service": "Firefly III",
      "description": "Cache backend driver",
      "secret": false,
      "strategy": "default",
      "default": "file"
    },
    {
      "key": "APP_LOG_LEVEL",
      "service": "Firefly III",
      "description": "Minimum log severity level",
      "secret": false,
      "strategy": "default",
      "default": "notice"
    },
    {
      "key": "COOKIE_SECURE",
      "service": "Firefly III",
      "description": "Enforce HTTPS-only cookies",
      "secret": false,
      "strategy": "default",
      "default": "true"
    },
    {
      "key": "DB_CONNECTION",
      "service": "Firefly III",
      "description": "Database driver type",
      "secret": false,
      "strategy": "default",
      "default": "pgsql"
    },
    {
      "key": "SESSION_DRIVER",
      "service": "Firefly III",
      "description": "Session storage driver",
      "secret": false,
      "strategy": "default",
      "default": "file"
    },
    {
      "key": "COOKIE_SAMESITE",
      "service": "Firefly III",
      "description": "Cookie SameSite attribute",
      "secret": false,
      "strategy": "default",
      "default": "lax"
    },
    {
      "key": "RAILWAY_RUN_UID",
      "service": "Firefly III",
      "description": "Run as root for volume perms",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "TRUSTED_PROXIES",
      "service": "Firefly III",
      "description": "Trust Railway's TLS-terminating proxy",
      "secret": false,
      "strategy": "default",
      "default": "*"
    },
    {
      "key": "DEFAULT_LANGUAGE",
      "service": "Firefly III",
      "description": "Default UI language for users",
      "secret": false,
      "strategy": "default",
      "default": "en_US"
    },
    {
      "key": "STATIC_CRON_TOKEN",
      "service": "Firefly III",
      "description": "Token for cron endpoint auth",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "PGDATA",
      "service": "Postgres",
      "description": "Postgres data storage directory",
      "secret": false,
      "strategy": "default",
      "default": "/var/lib/postgresql/data/pgdata"
    },
    {
      "key": "PGHOST",
      "service": "Postgres",
      "description": "Internal Postgres host address",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "PGPORT",
      "service": "Postgres",
      "description": "Postgres server listening port",
      "secret": false,
      "strategy": "default",
      "default": "5432"
    },
    {
      "key": "PGUSER",
      "service": "Postgres",
      "description": "Default Postgres username",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGDATABASE",
      "service": "Postgres",
      "description": "Default database name",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "PGPASSWORD",
      "service": "Postgres",
      "description": "Password for Postgres user",
      "secret": true,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "POSTGRES_DB",
      "service": "Postgres",
      "description": "Initial database created on startup",
      "secret": false,
      "strategy": "default",
      "default": "railway"
    },
    {
      "key": "DATABASE_URL",
      "service": "Postgres",
      "description": "Internal Postgres connection string",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "railway_private_domain"
    },
    {
      "key": "POSTGRES_USER",
      "service": "Postgres",
      "description": "Default database superuser name",
      "secret": false,
      "strategy": "default",
      "default": "postgres"
    },
    {
      "key": "SSL_CERT_DAYS",
      "service": "Postgres",
      "description": "Self-signed SSL certificate validity",
      "secret": false,
      "strategy": "default",
      "default": "820"
    },
    {
      "key": "POSTGRES_PASSWORD",
      "service": "Postgres",
      "description": "Postgres database user password",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "DATABASE_PUBLIC_URL",
      "service": "Postgres",
      "description": "Public Postgres connection string",
      "secret": false,
      "strategy": "railway_provided",
      "railway_source": "reference_variable"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "Postgres",
      "description": "Graceful shutdown draining duration",
      "secret": false,
      "strategy": "default",
      "default": "60"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "firefly-iii"
      }
    },
    "cli": "railway deploy --template firefly-iii",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "0f57064b-e077-40bc-a871-15b97660addb",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "93c5a499-19b6-4ad0-a288-9045626585b6": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/firefly-iii.svg",
                  "name": "Firefly III",
                  "deploy": {
                    "startCommand": "/bin/sh -c 'mkdir -p /var/www/html/storage/framework/views/twig /var/www/html/storage/framework/cache/data /var/www/html/storage/framework/sessions /var/www/html/storage/logs && chmod -R 777 /var/www/html/storage && (sleep 90; chmod -R 777 /var/www/html/storage) & exec docker-php-serversideup-entrypoint /init'",
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "fireflyiii/core:latest"
                  },
                  "variables": {
                    "TZ": {
                      "isOptional": false,
                      "description": "Application timezone",
                      "defaultValue": "UTC"
                    },
                    "PORT": {
                      "isOptional": false,
                      "description": "HTTP server listening port",
                      "defaultValue": "8080"
                    },
                    "APP_ENV": {
                      "isOptional": false,
                      "description": "Application environment mode",
                      "defaultValue": "production"
                    },
                    "APP_KEY": {
                      "isOptional": false,
                      "description": "32-char encryption key for sessions",
                      "defaultValue": "{{APP_KEY}}"
                    },
                    "APP_URL": {
                      "isOptional": false,
                      "description": "Public-facing application URL",
                      "defaultValue": "https://${{RAILWAY_PUBLIC_DOMAIN}}"
                    },
                    "DB_HOST": {
                      "isOptional": false,
                      "description": "PostgreSQL hostname via Railway ref",
                      "defaultValue": "${{Postgres.PGHOST}}"
                    },
                    "DB_PORT": {
                      "isOptional": false,
                      "description": "PostgreSQL port via Railway ref",
                      "defaultValue": "${{Postgres.PGPORT}}"
                    },
                    "APP_DEBUG": {
                      "isOptional": false,
                      "description": "Disable debug output in production",
                      "defaultValue": "false"
                    },
                    "SITE_OWNER": {
                      "isOptional": false,
                      "description": "Admin contact email address",
                      "defaultValue": "mail@example.com"
                    },
                    "DB_DATABASE": {
                      "isOptional": false,
                      "description": "Database name via Railway ref",
                      "defaultValue": "${{Postgres.PGDATABASE}}"
                    },
                    "DB_PASSWORD": {
                      "isOptional": false,
                      "description": "Database password via Railway ref",
                      "defaultValue": "${{Postgres.PGPASSWORD}}"
                    },
                    "DB_USERNAME": {
                      "isOptional": false,
                      "description": "Database user via Railway ref",
                      "defaultValue": "${{Postgres.PGUSER}}"
                    },
                    "LOG_CHANNEL": {
                      "isOptional": false,
                      "description": "Laravel log output destination",
                      "defaultValue": "stack"
                    },
                    "MAIL_MAILER": {
                      "isOptional": false,
                      "description": "Mail driver (log = no email)",
                      "defaultValue": "log"
                    },
                    "CACHE_DRIVER": {
                      "isOptional": false,
                      "description": "Cache backend driver",
                      "defaultValue": "file"
                    },
                    "APP_LOG_LEVEL": {
                      "isOptional": false,
                      "description": "Minimum log severity level",
                      "defaultValue": "notice"
                    },
                    "COOKIE_SECURE": {
                      "isOptional": false,
                      "description": "Enforce HTTPS-only cookies",
                      "defaultValue": "true"
                    },
                    "DB_CONNECTION": {
                      "isOptional": false,
                      "description": "Database driver type",
                      "defaultValue": "pgsql"
                    },
                    "SESSION_DRIVER": {
                      "isOptional": false,
                      "description": "Session storage driver",
                      "defaultValue": "file"
                    },
                    "COOKIE_SAMESITE": {
                      "isOptional": false,
                      "description": "Cookie SameSite attribute",
                      "defaultValue": "lax"
                    },
                    "RAILWAY_RUN_UID": {
                      "isOptional": false,
                      "description": "Run as root for volume perms",
                      "defaultValue": "0"
                    },
                    "TRUSTED_PROXIES": {
                      "isOptional": false,
                      "description": "Trust Railway's TLS-terminating proxy",
                      "defaultValue": "*"
                    },
                    "DEFAULT_LANGUAGE": {
                      "isOptional": false,
                      "description": "Default UI language for users",
                      "defaultValue": "en_US"
                    },
                    "STATIC_CRON_TOKEN": {
                      "isOptional": false,
                      "description": "Token for cron endpoint auth",
                      "defaultValue": "{{STATIC_CRON_TOKEN}}"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>": {}
                    }
                  },
                  "volumeMounts": {
                    "93c5a499-19b6-4ad0-a288-9045626585b6": {
                      "mountPath": "/var/www/html/storage/upload"
                    }
                  }
                },
                "bd0bab4f-fbb0-4b73-9734-e73e3343fad0": {
                  "icon": "https://devicons.railway.app/i/postgresql.svg",
                  "name": "Postgres",
                  "deploy": {
                    "startCommand": null,
                    "healthcheckPath": null,
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "ghcr.io/railwayapp-templates/postgres-ssl:18"
                  },
                  "variables": {
                    "PGDATA": {
                      "isOptional": false,
                      "description": "Postgres data storage directory",
                      "defaultValue": "/var/lib/postgresql/data/pgdata"
                    },
                    "PGHOST": {
                      "isOptional": false,
                      "description": "Internal Postgres host address",
                      "defaultValue": "${{RAILWAY_PRIVATE_DOMAIN}}"
                    },
                    "PGPORT": {
                      "isOptional": false,
                      "description": "Postgres server listening port",
                      "defaultValue": "5432"
                    },
                    "PGUSER": {
                      "isOptional": false,
                      "description": "Default Postgres username",
                      "defaultValue": "${{POSTGRES_USER}}"
                    },
                    "PGDATABASE": {
                      "isOptional": false,
                      "description": "Default database name",
                      "defaultValue": "${{POSTGRES_DB}}"
                    },
                    "PGPASSWORD": {
                      "isOptional": false,
                      "description": "Password for Postgres user",
                      "defaultValue": "${{POSTGRES_PASSWORD}}"
                    },
                    "POSTGRES_DB": {
                      "isOptional": false,
                      "description": "Initial database created on startup",
                      "defaultValue": "railway"
                    },
                    "DATABASE_URL": {
                      "isOptional": false,
                      "description": "Internal Postgres connection string",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_PRIVATE_DOMAIN}}:5432/${{PGDATABASE}}"
                    },
                    "POSTGRES_USER": {
                      "isOptional": false,
                      "description": "Default database superuser name",
                      "defaultValue": "postgres"
                    },
                    "SSL_CERT_DAYS": {
                      "isOptional": false,
                      "description": "Self-signed SSL certificate validity",
                      "defaultValue": "820"
                    },
                    "POSTGRES_PASSWORD": {
                      "isOptional": false,
                      "description": "Postgres database user password",
                      "defaultValue": "{{POSTGRES_PASSWORD}}"
                    },
                    "DATABASE_PUBLIC_URL": {
                      "isOptional": false,
                      "description": "Public Postgres connection string",
                      "defaultValue": "postgresql://${{PGUSER}}:${{POSTGRES_PASSWORD}}@${{RAILWAY_TCP_PROXY_DOMAIN}}:${{RAILWAY_TCP_PROXY_PORT}}/${{PGDATABASE}}"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": false,
                      "description": "Graceful shutdown draining duration",
                      "defaultValue": "60"
                    }
                  },
                  "volumeMounts": {
                    "bd0bab4f-fbb0-4b73-9734-e73e3343fad0": {
                      "mountPath": "/var/lib/postgresql/data"
                    }
                  },
                  "haTemplateCode": "postgres-ha",
                  "haConversionConfig": {
                    "edge": {
                      "label": "Reverse Proxy",
                      "options": [
                        2,
                        3,
                        4,
                        5
                      ],
                      "nodeLabel": "HAProxy",
                      "description": "Routes traffic to the primary",
                      "defaultValue": 3
                    },
                    "replica": {
                      "label": "Replicas",
                      "options": [
                        2,
                        3,
                        4,
                        5,
                        6,
                        7
                      ],
                      "nodeLabel": "Postgres",
                      "description": "Streaming replicas for automatic failover",
                      "defaultValue": 2
                    },
                    "internal": {
                      "label": "Coordinator Nodes",
                      "options": [
                        3,
                        5,
                        7,
                        9
                      ],
                      "nodeLabel": "etcd",
                      "defaultValue": 3
                    },
                    "description": "This will convert your Postgres database to an HA cluster with Patroni failover and etcd consensus."
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {},
  "resources": {
    "expected_services": 2,
    "needs_volume": true
  },
  "generated_at": "2026-09-22T04:14:41.730Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-09-20T13:33:30.567Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_4ee9b0e975a746ea9390",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 72,
    "typical_build_seconds": 0,
    "typical_start_seconds": 10,
    "slowest_service": "Firefly III"
  }
}