{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/heyform",
  "slug": "heyform",
  "name": "Heyform",
  "tagline": "Form builder for surveys and data collection that you host yourself.",
  "replaces": {
    "summary": "Paid online form services, such as Typeform.",
    "products": [
      {
        "slug": "typeform",
        "name": "Typeform",
        "vendor": "Typeform",
        "url": "https://openlogs.fyi/alternatives/typeform"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "TypeScript"
    }
  ],
  "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/heyform/heyform/blob/705c8d6ec5c22d3d98eecb52838134e1f383e19e/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/heyform/heyform/blob/705c8d6ec5c22d3d98eecb52838134e1f383e19e/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "3 services (1 database or broker: keydb), 3 volume mounts, no env values to set, no elevated host access. Heuristic score 3 of 11: medium."
  },
  "repository": {
    "owner": "heyform",
    "name": "heyform",
    "url": "https://github.com/heyform/heyform"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "content/5.open-source/2.self-hosting.md",
    "source_repo": "heyform/docs",
    "source_commit_sha": "b9056fb59ff07b4adc73133b384362a6640e1ab3",
    "source_kind": "packaging_repo",
    "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md#L69-L112",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the code block as docker-compose.yml",
      "body": "networks:\n  keydb:\n  mongo:\n\nservices:\n  heyform:\n    image: heyform/community-edition:latest\n    restart: always\n    volumes:\n      # Persist uploaded images\n      - ./assets:/app/static/upload\n    depends_on:\n      - mongo\n      - keydb\n    ports:\n      - '9157:9157'\n    environment:\n      APP_HOMEPAGE_URL: http://127.0.0.1:9157\n      SESSION_KEY: key1\n      FORM_ENCRYPTION_KEY: key2\n      MONGO_URI: 'mongodb://mongo:27017/heyform'\n      REDIS_HOST: keydb\n      REDIS_PORT: 6379\n\n  mongo:\n    image: percona/percona-server-mongodb:4.4\n    restart: always\n    volumes:\n      # Persist MongoDB data\n      - mongodb_data:/data/db\n\n  keydb:\n    image: eqalpha/keydb:x86_64_v6.3.3\n    restart: always\n    command: keydb-server --appendonly yes --protected-mode no\n    volumes:\n      # Persist KeyDB data\n      - keydb:/data\n\nvolumes:\n  mongodb_data:\n  keydb:\n",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "This compose file is copied unchanged from the code block in https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md#L69-L112. The check ran on that block alone. The self-hosting guide shows this docker-compose.yml with all dependencies and environment variables.",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md#L69-L112",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:9157. The compose file publishes host port 9157 for the heyform service.",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: heyform: heyform/community-edition:latest. A later pull can get a different version.",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 9157 (heyform). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./assets at /app/static/upload (heyform).",
      "source_url": "https://github.com/heyform/docs/blob/b9056fb59ff07b4adc73133b384362a6640e1ab3/content/5.open-source/2.self-hosting.md",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 9047,
    "forks": 723,
    "open_issues": 8,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v3.0.4",
    "latest_release_date": "2026-10-15",
    "days_since_release": 7
  },
  "links": {
    "html": "https://openlogs.fyi/tools/heyform",
    "markdown": "https://openlogs.fyi/tools/heyform.md",
    "json": "https://openlogs.fyi/tools/heyform.json"
  },
  "updated_at": "2026-10-22"
}