https://github.com/geoxor/runix
A general docker github action runner that you can self host for your action scripts in your organizations
https://github.com/geoxor/runix
docker github-runner self-hosted-runner
Last synced: 4 months ago
JSON representation
A general docker github action runner that you can self host for your action scripts in your organizations
- Host: GitHub
- URL: https://github.com/geoxor/runix
- Owner: Geoxor
- Created: 2021-11-30T17:10:07.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-12-04T20:00:54.000Z (about 3 years ago)
- Last Synced: 2025-09-13T11:24:49.067Z (5 months ago)
- Topics: docker, github-runner, self-hosted-runner
- Language: Dockerfile
- Homepage:
- Size: 33.2 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎃 Introduction
This is my docker image for my self-hosted [GitHub Actions](https://github.com/features/actions) runners
as self-hosted runners tend to be a lot faster since you can dedicate a server or multiple for an organization
as supposed to how github runs multiple dockers on the same machine making compile times take really long
It tries to emitate a very lite version of what the [GitHub Official Runners](https://github.com/actions/runner) have and you can farther take
this and build your own purpose built runner for your repo to improve performance
by editing the `Dockerfile` installing everything your repo needs
# 🛠 Installed Tools
- gcc-i386
- gcc-mips
- gcc-mipsel
- gcc-aarch64
- [upx 3.96](https://github.com/upx/upx)
- build-essential
- curl
- wget
- [go](https://go.dev)
- [gox](https://github.com/mitchellh/gox)
- sudo
- curl
- jq
- python3
- pip
- node.js
- rust
- cargo
- npm
- docker
- typescript
- ts-node
- cross
# 🗃 Setup
Install [Docker](https://www.docker.com/products/docker-desktop)
Edit the `docker-compose.yml` and add your organization & access token
_make sure your access token has the correct permissions_
Do this so dockers within the runners can execute
```bash
chmod 777 /var/run/docker.sock
```
# ☄ Usage
### 🐳 Docker Compose
- `docker-compose build` - build image
- `docker-compose up --scale runner=8 -d` - start 8 instances
- `docker-compose up --scale runner=12 -d` - go from 8 -> 12 instances
- `docker-compose down` - stop all