noxway/gitwall-runner repository overview

⁠GitWall Runner

Self-hosted CI/CD runner for GitWall⁠. Polls a GitWall server for pending pipeline jobs, executes them in isolated temporary directories, and reports results back.

⁠Quick Start

Add the runner to your existing GitWall docker-compose.yml. The runner communicates with the GitWall container directly over the Docker network using the service name:

services:
  gitwall:
    image: noxway/gitwall:latest
    # ... your existing gitwall config

  runner:
    image: noxway/gitwall-runner:latest
    restart: unless-stopped
    environment:
      GITWALL_URL: http://gitwall:8080
      RUNNER_NAME: my-runner
    volumes:
      - runner-data:/data
      - /var/run/docker.sock:/var/run/docker.sock
    depends_on:
      - gitwall

volumes:
  runner-data:

After starting, approve the runner in the GitWall admin panel at /-/admin/runners.

⁠Environment Variables

⁠How It Works

1. Runner generates a token on first start and registers with the GitWall server
2. Admin approves the runner at /-/admin/runners
3. Runner polls /api/v1/runner/poll for pending jobs
4. Each job runs in an isolated temp directory, cleaned up after completion
5. Logs and step results are streamed back to the server in real time

⁠Supported Actions

⁠GitWall Native (.gitwall/ workflows)

⁠GitHub Actions Compatible

The runner also accepts GitHub Actions syntax for common actions:

actions/checkout, actions/setup-go, actions/setup-node, actions/setup-python, actions/upload-artifact, actions/download-artifact, docker/login-action, docker/setup-buildx-action, docker/build-push-action, docker/metadata-action, softprops/action-gh-release

⁠Docker Socket

Mount /var/run/docker.sock to enable Docker build and push actions. The runner uses the host Docker daemon — no Docker-in-Docker required.

⁠Security

• Runner token is generated locally and stored in RUNNER_STATE_FILE
• Each job runs in a fresh temp directory, deleted after completion
• Secrets are masked in all log output
• Admin approval required before the runner receives any jobs