Get Started

Run one binary on your machine. We handle the rest.

Beta: manual setup

The automated GitHub App is coming. For now, email us your GitHub username and repo. We will send you a token.

01
request access

Email us your GitHub username and repository. We will set up the webhook and reply with your token.

email for access
02
download and run

We will send a download link. The worker is a single binary (~12MB). Run it with your token.

chmod +x horseci-worker
export HORSECI_TOKEN=your_token_here
./horseci-worker

Supported: Linux x86_64, ARM64. macOS x86_64, ARM64.

03
push code

The worker connects to our dispatcher. When you push, we route the webhook immediately. Your worker runs the build.

First run checks out the repo. Second run is fast.

Requirements

  • GitHub repository with .github/workflows/*.yml
  • Machine with 2GB RAM, 1GB disk
  • Outbound HTTPS/WSS to run.horseci.com
  • Docker installed (optional)
request beta access