Hackerrun CLI

Deploy apps with full control over your infrastructure. Hackerrun provides a Railway/Render-like experience on top of Ubicloud VMs with Uncloud container orchestration.

Quick Start

# Install
npm install -g hackerrun

# Login (one-time GitHub OAuth)
hackerrun login

# Deploy your app
cd myapp
hackerrun deploy
# => App live at https://laughing-buddha.hackerrun.app

Commands

| Command | Description | |---------|-------------| | hackerrun login | Authenticate via GitHub | | hackerrun deploy | Deploy your application | | hackerrun apps | List all your apps | | hackerrun logs <app> | View application logs | | hackerrun ssh <app> | SSH into app's VM | | hackerrun destroy <app> | Delete app and infrastructure | | hackerrun link <app> | Link current directory to an existing app | | hackerrun rename --app <old> <new> | Rename an app | | hackerrun domain --app <app> <new> | Change app's domain |

How It Works

1. First deploy creates an IPv6-only VM on Ubicloud
2. Your app is containerized and deployed via Uncloud
3. Traffic flows through our gateway: User → Cloudflare → Gateway → Your App
4. Apps get a random domain like laughing-buddha.hackerrun.app

App Naming

| Identifier | Scope | Example | |------------|-------|---------| | App Name | Per user | myapp (you choose) | | Domain | Global | laughing-buddha (auto-generated) |

You can change the domain anytime with hackerrun domain.

Configuration Files

• hackerrun.yml - Docker Compose file for production with x-ports for public exposure
• docker-compose.yml - Local development (ignored by hackerrun)

Example hackerrun.yml

services:
  web:
    build: .
    x-ports:
      - "3000/http"

The x-ports extension exposes your service publicly through the gateway.

Domains

| Domain | Purpose | |--------|---------| | hackerrun.com | Platform website & dashboard | | hackerrun.app | Your deployed applications |

Domain Format

• Single service: {domain}.hackerrun.app
• Multi-service: {domain}-{service}.hackerrun.app

Development

# Build
npm run build

# Run in development
npm run dev -- <command>

# Link globally for testing
npm link

License

MIT