Skip to content
/ runner Public

Zero config vercel like preview deployments using docker

Notifications You must be signed in to change notification settings

fipso/runner

Repository files navigation

Runner

image

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

About

Zero config vercel like preview deployments using docker

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages