{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/healthchecks",
  "slug": "healthchecks",
  "name": "Healthchecks",
  "tagline": "Monitor for cron jobs and scheduled tasks that alerts you when an expected ping is missing.",
  "replaces": {
    "summary": "Paid cron job monitoring services, such as Cronitor.",
    "products": [
      {
        "slug": "cronitor",
        "name": "Cronitor",
        "vendor": "Cronitor",
        "url": "https://openlogs.fyi/alternatives/cronitor"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Python"
    },
    {
      "kind": "database",
      "name": "PostgreSQL"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "BSD-3-Clause",
    "class": "osi",
    "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/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/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "2 services (1 database or broker: postgres), 1 volume mount, 3 env values to set, no elevated host access. Heuristic score 3 of 11: medium. A source checkout is needed, and the first start builds images from source, so the rating is at least medium."
  },
  "repository": {
    "owner": "healthchecks",
    "name": "healthchecks",
    "url": "https://github.com/healthchecks/healthchecks"
  },
  "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": "healthchecks/healthchecks",
    "source_commit_sha": "f09c4397430d3e70090a0494bc1b8e732396c1cb",
    "source_kind": "app_repo",
    "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/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/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "shell",
      "language": "bash",
      "label": "Get the source at commit f09c439",
      "body": "git init healthchecks\ncd healthchecks\ngit remote add origin https://github.com/healthchecks/healthchecks.git\ngit fetch --depth 1 origin f09c4397430d3e70090a0494bc1b8e732396c1cb\ngit checkout FETCH_HEAD",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 3,
      "kind": "shell",
      "language": "bash",
      "label": "Go to the folder the docs use",
      "body": "cd docker",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "compose",
      "language": "yaml",
      "label": "The compose file in the checkout: docker/docker-compose.yml (shown here for reading)",
      "body": "volumes:\n    db-data:\n\nservices:\n  db:\n    image: postgres:16\n    volumes:\n      - db-data:/var/lib/postgresql/data\n    environment:\n      - POSTGRES_DB=$DB_NAME\n      - POSTGRES_PASSWORD=$DB_PASSWORD\n  web:\n    build:\n        context: ..\n        dockerfile: docker/Dockerfile\n    # To use a pre-built image, remove the above \"build\" section\n    # and uncomment the following line:\n    # image: healthchecks/healthchecks:latest\n    env_file:\n        - .env\n    ports:\n        - \"8000:8000\"\n        # To enable SMTP on port 2525, set SMTPD_PORT=2525 in .env\n        # and uncomment the following line:\n        # - \"2525:2525\"\n    depends_on:\n        - db\n    command: bash -c 'while !</dev/tcp/db/5432; do sleep 1; done; /opt/healthchecks/run.sh'\n\n",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 5,
      "kind": "shell",
      "language": "bash",
      "label": "Copy .env.example to .env",
      "body": "cp .env.example .env",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran in a checkout of healthchecks/healthchecks at f09c4397430d3e70090a0494bc1b8e732396c1cb (a sparse checkout: the top-level files and the folder docker), in the folder docker, after .env.example was copied to .env. The Docker guide of the repository tells the reader to copy docker/.env.example to docker/.env, fill in the settings and run docker compose up in the docker folder.",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 7,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 8,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:8000. The compose file publishes host port 8000 for the web service. The guide says to open this address and log in with the superuser that the createsuperuser command makes.",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some services build from source",
      "body": "These services have a build section and no image: web. They need the project source next to the compose file.",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 8000 (web). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The first start builds images from source",
      "body": "The compose file has a build section. The first docker compose up builds the image from the checkout, which needs time, disk space and network access.",
      "source_url": "https://github.com/healthchecks/healthchecks/blob/f09c4397430d3e70090a0494bc1b8e732396c1cb/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 10440,
    "forks": 1028,
    "open_issues": 55,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v5.0.1",
    "latest_release_date": "2026-10-22",
    "days_since_release": 0
  },
  "links": {
    "html": "https://openlogs.fyi/tools/healthchecks",
    "markdown": "https://openlogs.fyi/tools/healthchecks.md",
    "json": "https://openlogs.fyi/tools/healthchecks.json"
  },
  "updated_at": "2026-10-22"
}