{"id":30223673,"url":"https://github.com/killwolfvlad/actions-runner-compose","last_synced_at":"2026-04-13T06:34:11.402Z","repository":{"id":309789759,"uuid":"1036834777","full_name":"KillWolfVlad/actions-runner-compose","owner":"KillWolfVlad","description":"Like Kubernetes controller for GitHub Actions self-hosted runners but for Docker Compose","archived":false,"fork":false,"pushed_at":"2025-08-13T20:16:04.000Z","size":1565,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-13T21:24:44.955Z","etag":null,"topics":["compose","docker","docker-compose","github-actions"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KillWolfVlad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-12T16:47:18.000Z","updated_at":"2025-08-13T20:16:07.000Z","dependencies_parsed_at":"2025-08-13T21:24:49.305Z","dependency_job_id":"3188d997-f1cd-43a1-b5d4-22da0f4f5b32","html_url":"https://github.com/KillWolfVlad/actions-runner-compose","commit_stats":null,"previous_names":["killwolfvlad/actions-runner-compose"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/KillWolfVlad/actions-runner-compose","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KillWolfVlad%2Factions-runner-compose","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KillWolfVlad%2Factions-runner-compose/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KillWolfVlad%2Factions-runner-compose/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KillWolfVlad%2Factions-runner-compose/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KillWolfVlad","download_url":"https://codeload.github.com/KillWolfVlad/actions-runner-compose/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KillWolfVlad%2Factions-runner-compose/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270422670,"owners_count":24580836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-14T02:00:10.309Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["compose","docker","docker-compose","github-actions"],"created_at":"2025-08-14T12:48:30.281Z","updated_at":"2026-04-13T06:34:11.385Z","avatar_url":"https://github.com/KillWolfVlad.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# actions-runner-compose\n\n[![deploy-image](https://github.com/KillWolfVlad/actions-runner-compose/actions/workflows/deploy-image.yaml/badge.svg?branch=master)](https://github.com/KillWolfVlad/actions-runner-compose/actions/workflows/deploy-image.yaml)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./brand/logo.png\" width=\"250\"/\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\nLike [Kubernetes controller for GitHub Actions self-hosted runners](https://github.com/actions/actions-runner-controller) but for Docker Compose.\n\n## Install\n\n### On Your Server\n\n1. `mkdir actions-runner-compose \u0026\u0026 cd actions-runner-compose`\n2. `nano .env` with content from [.env.example](./.env.example)\n3. `nano compose.yaml` with content below (you can find versions in [GitHub Packages](https://github.com/users/KillWolfVlad/packages/container/package/actions-runner-compose))\n\n```yaml\nname: actions-runner-compose\n\nservices:\n  actions-runner-compose:\n    container_name: arc\n    image: ghcr.io/killwolfvlad/actions-runner-compose:latest\n    restart: unless-stopped\n    environment:\n      PORT: \"8080\"\n      WEBHOOK_PATH: ${WEBHOOK_PATH}\n      WEBHOOK_SECRET: ${WEBHOOK_SECRET}\n      MAX_RUNNERS: ${MAX_RUNNERS}\n      RUNNER_IMAGE: ${RUNNER_IMAGE}\n      REPOSITORY_0: ${REPOSITORY_0}\n      REPOSITORY_1: ${REPOSITORY_1}\n    ports:\n      - 8080:8080\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock\n```\n\n4. `docker compose up -d`\n5. Setup Caddy or any other reverse proxy\n\n```caddy\nyourdomain.com {\n    reverse_proxy http://localhost:8080\n}\n```\n\n### Setup Webhook in GitHub Repository\n\n- Payload URL: `https://yourdomain.com/${WEBHOOK_PATH}`\n- Content type: `application/json`\n- Secret: `${WEBHOOK_SECRET}`\n- SSL verification: `Enable SSL verification`\n- Which events would you like to trigger this webhook: `Let me select individual events.`\n  - `Workflow jobs`\n- Active: `true`\n\n## Maintainers\n\n- [@KillWolfVlad](https://github.com/KillWolfVlad)\n\n## License\n\nThis repository is released under version 2.0 of the\n[Apache License](https://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillwolfvlad%2Factions-runner-compose","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkillwolfvlad%2Factions-runner-compose","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkillwolfvlad%2Factions-runner-compose/lists"}