{"id":22427802,"url":"https://github.com/ulm0/gitlab-runner","last_synced_at":"2025-08-01T10:32:15.496Z","repository":{"id":38210004,"uuid":"120633448","full_name":"ulm0/gitlab-runner","owner":"ulm0","description":"GitLab Runner (Docker image) for ARM devices, this is a mirror repository of","archived":false,"fork":false,"pushed_at":"2022-06-09T02:47:51.000Z","size":410,"stargazers_count":21,"open_issues_count":0,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-30T08:04:14.649Z","etag":null,"topics":["arm","armhf","armv7","docker","gitlab","gitlab-ci","gitlab-cli","gitlab-mirror","gitlab-runner","raspberry","raspberry-pi","raspberry-pi-3"],"latest_commit_sha":null,"homepage":"https://gitlab.com/ulm0/gitlab-runner","language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ulm0.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}},"created_at":"2018-02-07T15:32:47.000Z","updated_at":"2024-01-05T13:47:48.000Z","dependencies_parsed_at":"2022-09-04T13:01:53.222Z","dependency_job_id":null,"html_url":"https://github.com/ulm0/gitlab-runner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulm0%2Fgitlab-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulm0%2Fgitlab-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulm0%2Fgitlab-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ulm0%2Fgitlab-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ulm0","download_url":"https://codeload.github.com/ulm0/gitlab-runner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228364000,"owners_count":17908319,"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":["arm","armhf","armv7","docker","gitlab","gitlab-ci","gitlab-cli","gitlab-mirror","gitlab-runner","raspberry","raspberry-pi","raspberry-pi-3"],"created_at":"2024-12-05T20:12:54.769Z","updated_at":"2024-12-05T20:12:55.473Z","avatar_url":"https://github.com/ulm0.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitLab Runner for ARM\n\n[![pipeline status](https://gitlab.com/ulm0/gitlab-runner/badges/master/pipeline.svg)](https://gitlab.com/ulm0/gitlab-runner/-/commits/master) [![Docker Pulls](https://img.shields.io/docker/pulls/klud/gitlab-runner.svg)](https://hub.docker.com/r/klud/gitlab-runner/) [![Docker Pulls](https://img.shields.io/docker/stars/klud/gitlab-runner.svg)](https://hub.docker.com/r/klud/gitlab-runner/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n## Tags\n\n[![](https://images.microbadger.com/badges/version/klud/gitlab-runner:alpine.svg)](https://microbadger.com/images/klud/gitlab-runner:alpine \"Get your own version badge on microbadger.com\")\n\n[![](https://images.microbadger.com/badges/version/klud/gitlab-runner:ubuntu.svg)](https://microbadger.com/images/klud/gitlab-runner:ubuntu \"Get your own version badge on microbadger.com\")\n\n**Notes:**\n  - Alpine is the default image, when running `docker pull klud/gitlab-runner` this one is going to be downloaded depending on the runner arch, at the moment only arm is supported.\n  \u003c!-- - Currently only the alpine image is multi-arch. --\u003e\n\n## About the image\n\nThese image are built for ARM devices, based on the [official repo](https://gitlab.com/gitlab-org/gitlab-runner) of the GitLab Runner, both Alpine and Ubuntu flavors are available.\n\n## Overview\n\n### Runner container setup\n\nYou need to mount a config volume into our gitlab-runner container to be used for configs and other resources:\n\n```sh\ndocker run -d --name arm-runner \\\n-v $(pwd)/.runner:/etc/gitlab-runner \\\n--restart=always \\\nklud/gitlab-runner\n```\n\nOr you can use a config container to mount your custom data volume:\n\n```sh\ndocker run -d --name runner-config \\\n    -v /etc/gitlab-runner \\\n    armhf/busybox \\\n    /bin/true\n\ndocker run -d --name arm-runner --restart=always \\\n    --volumes-from runner-config \\\n    klud/gitlab-runner\n```\n\nIf you plan on using the Docker executor, it is necessary to mount the Docker socket this way:\n\n```sh\ndocker run -d --name arm-runner --restart=always \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  -v $(pwd)/.runner:/etc/gitlab-runner \\\n  klud/gitlab-runner\n```\n\nYou can achieve this by using a `docker-compose.yml` file as well:\n\n```yaml\nversion: \"2\"\nrunner:\n  image: klud/gitlab-runner\n  container_name: arm-runner\n  restart: always\n  volumes:\n    - $(pwd)/.runner:/etc/gitlab-runner\n    - /var/run/docker.sock:/var/run/docker.sock\n```\n\n### Register runner\n\nOnce the container is up and running, it is time to register the runner on the GitLab server\n\nYou can either do this:\n\n```sh\ndocker exec -it arm-runner gitlab-runner register\n\nPlease enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )\nhttps://gitlab.domain.tld\nPlease enter the gitlab-ci token for this runner\nXXXXXXXXXXXXXXXXXXXX\nPlease enter the gitlab-ci description for this runner\nARM Runner by ulm0\nINFO[0034] fcf5c619 Registering runner... succeeded\nPlease enter the executor: shell, docker, docker-ssh, ssh?\ndocker\nPlease enter the Docker image (eg. ruby:2.1):\ndocker:17.12\nINFO[0037] Runner registered successfully. Feel free to start it, but if it's\nrunning already the config should be automatically reloaded!\n```\n\nOr this:\n\n```sh\ndocker exec -it arm-runner \\\ngitlab-runner register -n \\\n--url https://gitlab.domain.tld \\\n--registration-token XXXXXXXXXXXXXXXXXXXX \\\n--executor docker \\\n--description \"ARM Runner by ulm0\" \\\n--docker-image \"docker:17.12\" \\\n--tag-list \"docker,arm\" \\\n--docker-privileged\n```\n\n## Troubleshooting\n\nIf you're using `docker in docker` in the runner, you may expirience some problems when talking to the docker socket\n\n```sh\nCannot connect to the Docker daemon. Is the docker daemon running on this host?\n```\n\nIn order to address this issue you need to look within the config folder you mounted in the runner container, there will be a config file inside, you need to add some lines and then restart the runner with `docker restart arm-runner`.\n\n```toml\nconcurrent = 1\ncheck_interval = 0\n\n[[runners]]\n  name = \"ARM Runner by ulm0\"\n  url = \"https://gitlab.domain.tld\"\n  token = \"XXXXXXXXXXXXXXXXXXXX\"\n  executor = \"docker\"\n  [runners.docker]\n    tls_verify = false\n    image = \"docker:17.12\"\n    ### IF YOU USED THE FIRST METHOD YOU NEED TO SET\n    ### THE RUNNER IN PRIVILEGED MODE TO BE ABLE TO SPAWN JOBS\n    privileged = true\n    disable_cache = false\n    ### YOU MAY NEED TO ADD THE CACHE DIR\n    cache_dir = \"cache\"\n    ### AND THE DOCKER SOCKET TO BE ABLE TO SPAWN JOBS AS WELL\n    volumes = [\"/var/run/docker.sock:/var/run/docker.sock\",\"/cache\"]\n  [runners.cache]\n```\n\n[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com) [![forthebadge](https://forthebadge.com/images/badges/for-you.svg)](https://forthebadge.com)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulm0%2Fgitlab-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fulm0%2Fgitlab-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulm0%2Fgitlab-runner/lists"}