Quick Start - LiteBin

Deploy via CLI

Build on your machine, stream the image to your server. No registry needed.

Install CLI locally:

curl -sSL https://l8b.in | bash -s cli

Make l8b available in your terminal:

Installed to ~/.local/bin. Add to your shell profile so it persists:

# bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# zsh (default on macOS)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Verify: which l8b should print the path.

Login to your master:

l8b login --server https://l8bin.example.com

Interactive deploy (auto-detects Dockerfile or uses Railpack):

l8b ship

Or deploy non-interactively:

l8b deploy --project myapp --port 3000

Dashboard UI

The easiest way to manage your apps — start, stop, configure, and view logs with a few clicks.

1

Go to your LiteBin dashboard

https://l8bin.example.com

2

Click "Deploy"

Enter an image from any public registry

3

Configure and deploy

Set project name, port, env vars

Example images:

nginx:alpine
node:20
ghcr.io/org/app:latest

Dashboard Management:

Start/StopControl app state with one click
ConfigureEdit env vars, ports, and resources
LogsView real-time app logs
DeleteRemove apps when no longer needed

App will be live at https://<app-name>.your-domain.com

Deploy via GitHub Actions

Auto-deploy on every push to main, or trigger a deploy manually from the GitHub Actions UI.

Create .github/workflows/deploy.yml:

name: Deploy
on:
  push:
    branches: [main]
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: mtsandeep/l8bin-action@v1
        with:
          server: ${{ secrets.L8B_SERVER }}
          token: ${{ secrets.L8B_TOKEN }}
          project_id: myapp

Required GitHub Secrets:

L8B_SERVERhttps://l8bin.example.com (orchestrator URL)
L8B_TOKENGenerate from Dashboard → Settings → API Tokens

Every push to main will now auto-deploy to your LiteBin cluster.

Connect GitHub

Native GitHub integration coming soon.

Direct GitHub repository linking

Auto-deploy without writing workflows

Coming Soon

Quick Start Guide

Install Master

Create Admin Account

Add Worker Nodes (Optional)

Choose Deployment Method

CLI

Dashboard UI

GitHub Actions

Connect GitHub

Deploy via CLI

Dashboard UI

Deploy via GitHub Actions

Connect GitHub