{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/ghostfolio",
  "slug": "ghostfolio",
  "name": "Ghostfolio",
  "tagline": "Wealth management app that tracks stocks, ETFs and cryptocurrency holdings.",
  "replaces": {
    "summary": "Paid portfolio tracking services, such as Mint.",
    "products": [
      {
        "slug": "mint",
        "name": "Mint",
        "vendor": "Intuit",
        "url": "https://openlogs.fyi/alternatives/mint"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "TypeScript"
    },
    {
      "kind": "database",
      "name": "PostgreSQL"
    },
    {
      "kind": "database",
      "name": "Redis"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "3 services (2 database or broker: postgres, redis), 1 volume mount, 1 env value to set, host access: cap_add. Heuristic score 5 of 11: medium. A source checkout is needed, so the rating is at least medium."
  },
  "repository": {
    "owner": "ghostfolio",
    "name": "ghostfolio",
    "url": "https://github.com/ghostfolio/ghostfolio"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker/docker-compose.yml",
    "source_repo": "ghostfolio/ghostfolio",
    "source_commit_sha": "0d58df7ce77acaddb657216a03782c9fed2d935d",
    "source_kind": "app_repo",
    "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin and git",
      "body": "A host with Docker, the Docker Compose plugin and git. This entry needs a checkout of the project repository.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "shell",
      "language": "bash",
      "label": "Get the source at commit 0d58df7",
      "body": "git init ghostfolio\ncd ghostfolio\ngit remote add origin https://github.com/ghostfolio/ghostfolio.git\ngit sparse-checkout init --cone\ngit sparse-checkout set docker\ngit fetch --depth 1 --filter=blob:none origin 0d58df7ce77acaddb657216a03782c9fed2d935d\ngit checkout FETCH_HEAD",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 3,
      "kind": "compose",
      "language": "yaml",
      "label": "The compose file in the checkout: docker/docker-compose.yml (shown here for reading)",
      "body": "name: ghostfolio\nservices:\n  ghostfolio:\n    image: docker.io/ghostfolio/ghostfolio:latest\n    container_name: ghostfolio\n    restart: unless-stopped\n    init: true\n    stop_grace_period: 1m\n    cap_drop:\n      - ALL\n    security_opt:\n      - no-new-privileges:true\n    env_file:\n      - ../.env\n    ports:\n      - 3333:3333\n    depends_on:\n      postgres:\n        condition: service_healthy\n      redis:\n        condition: service_healthy\n    healthcheck:\n      test: ['CMD-SHELL', 'curl -f http://localhost:3333/api/v1/health']\n      interval: 10s\n      timeout: 5s\n      retries: 5\n\n  postgres:\n    image: docker.io/library/postgres:15-alpine\n    container_name: gf-postgres\n    restart: unless-stopped\n    cap_drop:\n      - ALL\n    cap_add:\n      - CHOWN\n      - DAC_READ_SEARCH\n      - FOWNER\n      - SETGID\n      - SETUID\n    security_opt:\n      - no-new-privileges:true\n    env_file:\n      - ../.env\n    healthcheck:\n      test:\n        ['CMD-SHELL', 'pg_isready -d \"$${POSTGRES_DB}\" -U $${POSTGRES_USER}']\n      interval: 10s\n      timeout: 5s\n      retries: 5\n    volumes:\n      - postgres:/var/lib/postgresql/data\n\n  redis:\n    image: docker.io/library/redis:alpine\n    container_name: gf-redis\n    restart: unless-stopped\n    user: '999:1000'\n    cap_drop:\n      - ALL\n    security_opt:\n      - no-new-privileges:true\n    env_file:\n      - ../.env\n    command:\n      - /bin/sh\n      - -c\n      - redis-server --requirepass \"$${REDIS_PASSWORD:?REDIS_PASSWORD variable is not set}\"\n    healthcheck:\n      test:\n        ['CMD-SHELL', 'redis-cli --pass \"$${REDIS_PASSWORD}\" ping | grep PONG']\n      interval: 10s\n      timeout: 5s\n      retries: 5\n\nvolumes:\n  postgres:\n",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Copy .env.example to .env",
      "body": "cp .env.example .env",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran in a checkout of ghostfolio/ghostfolio at 0d58df7ce77acaddb657216a03782c9fed2d935d (a sparse checkout: the top-level files and the folder docker), after .env.example was copied to .env. The README tells the reader to clone the repository, copy .env.example to .env and run docker compose -f docker/docker-compose.yml up -d from the root folder.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose -f docker/docker-compose.yml up -d",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 7,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:3333. The compose file publishes host port 3333 for the ghostfolio service. The README says to open this address and create the first user.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: ghostfolio: docker.io/ghostfolio/ghostfolio:latest. A later pull can get a different version.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 3333 (ghostfolio). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "Some services get elevated host access",
      "body": "postgres adds Linux capabilities.",
      "source_url": "https://github.com/ghostfolio/ghostfolio/blob/0d58df7ce77acaddb657216a03782c9fed2d935d/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 9554,
    "forks": 1386,
    "open_issues": 337,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "3.90.0",
    "latest_release_date": "2026-10-21",
    "days_since_release": 1
  },
  "links": {
    "html": "https://openlogs.fyi/tools/ghostfolio",
    "markdown": "https://openlogs.fyi/tools/ghostfolio.md",
    "json": "https://openlogs.fyi/tools/ghostfolio.json"
  },
  "updated_at": "2026-10-22"
}
