Runner

Zero config vercel like preview deployments using docker

Status: Alpha ~ Should work

Features

• Web UI
  • Connect with git providers via OAuth
  • Add and configure deployments
  • Show build/runtime/request logs
• Github and Gitlab Webhook integration
  • Handle push event
• Fast builds using docker
• Comes with ready to use build templates:
  • NextJS
  • Vite
  • React
  • Static
• Templates are easy to modify using .toml files
• Automatic SSL using Let's Encrypt ACME
• SSH directly into container
• Detect package manager from package.json
• Authentication
• HTTP API

Stuff we dont care about for now

• Scalability
  • This tool is only for preview deployments
  • Prod maybe soon
• Security
  • Only deploy code you trust as docker containers provide no safety

Usage

• Using docker in docker:
  • curl -O "https://raw.githubusercontent.com/fipso/runner/main/docker-compose.yml"
  • Edit file and update domain
  • sudo docker-compose up -d
• Using a binary:
  • Download a runner build artifact
  • ./runner -domain mydomain.com -ssl

Dev Usage

• Start dev backend:
  • go mod tidy
  • go build
  • sudo ./runner -domain site1.local -port 1337
  • For air users (scuffed run as root workarround):
    • SUDO_PW=<your sudo pw> air
• Start dev frontend
  • cd www
  • bun install
  • bun run dev
• Access the Web UI on :3000