{"id":16344535,"url":"https://github.com/siddhant-k-code/gitpod-github-actions-self-hosted-runner","last_synced_at":"2026-05-17T06:32:58.924Z","repository":{"id":174403525,"uuid":"652113290","full_name":"Siddhant-K-code/gitpod-github-actions-self-hosted-runner","owner":"Siddhant-K-code","description":"Debugging GitHub Actions using Gitpod","archived":false,"fork":false,"pushed_at":"2023-06-12T15:21:00.000Z","size":252,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-17T03:09:30.899Z","etag":null,"topics":["cde","github-actions","gitpod","self-hosted","self-hosted-runner"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Siddhant-K-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-06-11T06:02:06.000Z","updated_at":"2024-09-21T01:41:09.000Z","dependencies_parsed_at":"2023-08-29T06:45:42.607Z","dependency_job_id":null,"html_url":"https://github.com/Siddhant-K-code/gitpod-github-actions-self-hosted-runner","commit_stats":null,"previous_names":["siddhant-k-code/gitpod-hosted-runner","siddhant-k-code/gitpod-github-actions-self-hosted-runner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddhant-K-code%2Fgitpod-github-actions-self-hosted-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddhant-K-code%2Fgitpod-github-actions-self-hosted-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddhant-K-code%2Fgitpod-github-actions-self-hosted-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddhant-K-code%2Fgitpod-github-actions-self-hosted-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Siddhant-K-code","download_url":"https://codeload.github.com/Siddhant-K-code/gitpod-github-actions-self-hosted-runner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239502361,"owners_count":19649657,"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","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":["cde","github-actions","gitpod","self-hosted","self-hosted-runner"],"created_at":"2024-10-11T00:28:35.494Z","updated_at":"2025-10-24T02:59:42.548Z","avatar_url":"https://github.com/Siddhant-K-code.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Debugging GitHub Actions using Gitpod\n\nTesting out the GitHub Actions is a tough task, especially when you are dealing with Self-Hosted Runners for your enterprises. With this repository, you can set up and use a self-hosted runner within [Gitpod's Cloud Development Environment (CDE)](https://www.gitpod.io/cde).\n\n## Setup\n\n### Step 1: Generate a GitHub Personal Access Token\n\nTo use a self-hosted runner, you need to [generate a personal access token (PAT) in GitHub](https://github.com/settings/tokens/new?description=Gitpod+and+Self+Hosted+Runner\u0026scopes=repo,admin:org,workflow). The token must have repo scope if you're going to use the runner with a private repository, or public_repo scope if you're going to use it with a public repository. You can use a PAT to configure each self-hosted runner or you can use the same PAT for each self-hosted runner that you create.\n\n### Step 2: Configure the GitHub Personal Access Token\n\nSet the GitHub Personal Access Token as `RUNNER_TOKEN` in [Gitpod Environment Variables](https://gitpod.io/user/variables) with scope to your repository `{REPO_OWNER_NAME}/{REPO_NAME}` for that certain repository (Recommended) OR `*/*` for all Repositories you will open in Gitpod Workspace.\n\n[![Env Variables](./docs/assets/gitpod-env-variable.png)](https://gitpod.io/user/variables)\n\n## Step 3: Start the Gitpod Workspace\n\nIt would open a fresh, ephemeral CDE with GitHub CLI Installed \u0026 ready-to-use.\n\n[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/Siddhant-K-code/gitpod-hosted-runner/)\n\n## Usage\n\n### Step 1: Create a Self-Hosted Runner\n\nYou can easily create a self-hosted runner using the [GitHub CLI](https://cli.github.com/). For example, the following command creates a self-hosted runner in the current repository. You can pass any preferred name for your runner.\n\n```bash\nsource create-runner.sh siddhant-demo-runner-01\n```\n\n### Step 2: Use \u0026 Run GitHub Action Workflow Self-Hosted Runner\n\nOnce the self-hosted runner is set up and running, you can utilize it in your GitHub Actions workflows.\n\n- Open your GitHub repository.\n- Navigate to the Actions tab.\n- Create or modify a workflow file (e.g., [.github/workflows/demo.yml](.github/workflows/demo.yml)).\n  Specify the runner label in your workflow file to target the self-hosted runner. For example:\n\n  ```yml\n  jobs:\n  build:\n    runs-on: self-hosted\n  ```\n\n- Commit and push your workflow file to trigger the workflow using the self-hosted runner.\n\n    ![Actions Workflow Output](./docs/assets/actions-workflow-output.png)\n---\n\n\u003e Here, `Machine name` will be your Gitpod Workspace URL.\n\n### 🗒️ Note\n\n#### ♻️ Reuse in Existing Gitpod Workspace\n\nIf you've got an existing Gitpod workspace that you want to turn into a runner:\n\n- Set the GitHub PAT Token above as Gitpod environment variables.\n- Run [create-runner.sh](./create-runner.sh) in the terminal with above instructions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddhant-k-code%2Fgitpod-github-actions-self-hosted-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddhant-k-code%2Fgitpod-github-actions-self-hosted-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddhant-k-code%2Fgitpod-github-actions-self-hosted-runner/lists"}