{
  "schema_version": 1,
  "generated_at": "2026-10-22T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/woodpecker-ci",
  "slug": "woodpecker-ci",
  "name": "Woodpecker CI",
  "tagline": "CI/CD engine with a server and agents that run pipeline steps in containers.",
  "replaces": {
    "summary": "Paid hosted CI/CD services, such as CircleCI.",
    "products": [
      {
        "slug": "circleci",
        "name": "CircleCI",
        "vendor": "CircleCI",
        "url": "https://openlogs.fyi/alternatives/circleci"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "Apache-2.0",
    "class": "osi",
    "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/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/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "2 services, 2 volume mounts, 4 env values to set, host access: docker_socket. Heuristic score 5 of 11: medium."
  },
  "repository": {
    "owner": "woodpecker-ci",
    "name": "woodpecker",
    "url": "https://github.com/woodpecker-ci/woodpecker"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker-compose.example.yaml",
    "source_repo": "woodpecker-ci/woodpecker",
    "source_commit_sha": "aca84ce05addae61c1cf24349d9636b2d396457a",
    "source_kind": "app_repo",
    "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml"
  },
  "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/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as compose.yaml",
      "body": "version: '3'\n\nservices:\n  woodpecker-server:\n    image: woodpeckerci/woodpecker-server:v3\n    ports:\n      - 8000:8000\n    networks:\n      - woodpecker\n    volumes:\n      - /var/lib/woodpecker:/var/lib/woodpecker/\n    environment:\n      - WOODPECKER_OPEN=true\n      - WOODPECKER_ADMIN=laszlocph\n      - WOODPECKER_HOST=${WOODPECKER_HOST}\n      - WOODPECKER_GITHUB=true\n      - WOODPECKER_GITHUB_CLIENT=${WOODPECKER_GITHUB_CLIENT}\n      - WOODPECKER_GITHUB_SECRET=${WOODPECKER_GITHUB_SECRET}\n      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}\n  woodpecker-agent:\n    depends_on:\n      woodpecker-server:\n        condition: service_healthy\n    image: woodpeckerci/woodpecker-agent:v3\n    networks:\n      - woodpecker\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock\n    environment:\n      - WOODPECKER_SERVER=woodpecker-server:9000\n      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}\n      - WOODPECKER_MAX_WORKFLOWS=2\n\nnetworks:\n  woodpecker:\n",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "env",
      "language": "text",
      "label": "Set the values the compose file needs",
      "body": "These variables have no default in the compose file: WOODPECKER_AGENT_SECRET, WOODPECKER_GITHUB_CLIENT, WOODPECKER_GITHUB_SECRET, WOODPECKER_HOST. Compose reads them from the shell or from a .env file next to the compose file.",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:8000. The compose file publishes host port 8000 for the woodpecker-server service.",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 8000 (woodpecker-server). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: /var/lib/woodpecker at /var/lib/woodpecker/ (woodpecker-server).",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "Some services get elevated host access",
      "body": "woodpecker-agent mounts the Docker socket, which gives it control of Docker on the host.",
      "source_url": "https://github.com/woodpecker-ci/woodpecker/blob/aca84ce05addae61c1cf24349d9636b2d396457a/docker-compose.example.yaml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 8031,
    "forks": 718,
    "open_issues": 391,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v3.19.0",
    "latest_release_date": "2026-10-07",
    "days_since_release": 14
  },
  "links": {
    "html": "https://openlogs.fyi/tools/woodpecker-ci",
    "markdown": "https://openlogs.fyi/tools/woodpecker-ci.md",
    "json": "https://openlogs.fyi/tools/woodpecker-ci.json"
  },
  "updated_at": "2026-10-22"
}