Installation

Choose the easiest method for your platform.

macOS

Option 1: Download .pkg (Easiest)

Platform	Download
Apple Silicon (M1/M2/M3)	LobstaKit-Installer-arm64.pkg (opens in a new tab)
Intel Mac	LobstaKit-Installer-amd64.pkg (opens in a new tab)

Just download and double-click — no terminal required! After installing, open Terminal and run:

lobstakit-installer install

Option 2: Homebrew

brew tap 0xrichyrich/tap
brew install lobstakit-installer

Then run:

lobstakit-installer install

Linux / Raspberry Pi

Option 1: AppImage (Easiest)

Download, make executable, and run — no installation needed:

Platform	Download
Linux x64	LobstaKit-Installer-x86_64.AppImage (opens in a new tab)

chmod +x LobstaKit-Installer-x86_64.AppImage
./LobstaKit-Installer-x86_64.AppImage install

Option 2: apt (Debian/Ubuntu/Raspberry Pi OS)

# Download the .deb for your architecture
# For x64:
curl -LO https://github.com/0xrichyrich/lobstakit-installer/releases/latest/download/lobstakit-installer_1.2.0_amd64.deb
sudo dpkg -i lobstakit-installer_1.2.0_amd64.deb
 
# For ARM64 (Raspberry Pi 4/5):
curl -LO https://github.com/0xrichyrich/lobstakit-installer/releases/latest/download/lobstakit-installer_1.2.0_arm64.deb
sudo dpkg -i lobstakit-installer_1.2.0_arm64.deb

Then run:

lobstakit-installer install

Option 3: Direct Binary Download

Platform	Download
Raspberry Pi 4/5 (ARM64)	lobstakit-installer-linux-arm64 (opens in a new tab)
Raspberry Pi 2/3/Zero (ARMv7)	lobstakit-installer-linux-armv7 (opens in a new tab)
Linux x64	lobstakit-installer-linux-amd64 (opens in a new tab)

chmod +x lobstakit-installer-linux-*
./lobstakit-installer-linux-arm64 install

One-Line Install (All Platforms)

For those comfortable with terminal scripts:

curl -fsSL https://get.redlobsta.com/kit | bash

💡

This script auto-detects your platform, downloads the right binary, and runs the installer.

Developer Options

pip

pip install lobstakit

For production mode with gunicorn:

pip install lobstakit[prod]

Docker (Web Dashboard Only)

docker run -d \
  --name lobstakit \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.lobsta:/root/.lobsta \
  ghcr.io/0xrichyrich/lobstakit:latest

Then open http://localhost:8080 in your browser.

Verify Installation

lobstakit-installer version
# LobstaKit Installer v1.2.0

Setup Wizard

After installing, run the setup wizard:

lobstakit-installer install

This walks you through:

Step 1: Checking Prerequisites

Check	What It Verifies
curl	Present on the system
git	Present (optional)
Internet	Can reach `api.anthropic.com`
Disk Space	At least 4 GB free
Memory	At least 2 GB total RAM

Step 2: Docker Setup

Checks if Docker is installed and running. If missing, offers to install it automatically.

💡

After being added to the docker group, you may need to log out and back in.

Step 3: Configuration

Anthropic API Key — your sk- prefixed key
Model Selection — Claude Sonnet 4 (recommended), Opus 4, or Haiku 3.5
Gateway Settings — port for the Lobsta gateway (default: 3000)
Telegram Integration — optional bot token and allowed user IDs
System Settings — timezone and auto-update preferences

Step 4: Download Lobsta

Pulls the Lobsta Docker image from ghcr.io/0xrichyrich/lobsta:latest.

Step 5: Start Lobsta

Starts the Lobsta container. Your instance is now running!

Configuration Files

All configuration is stored in ~/.lobsta/:

File	Contents
`config.yaml`	Model, port, timezone, image tag, auto-update
`.env`	API keys, Telegram tokens
`docker-compose.yml`	Generated Docker Compose config
`auth.json`	Web dashboard password hash

config.yaml Example

model: claude-sonnet-4-20250514
gateway_port: 3000
gateway_host: 0.0.0.0
image_tag: latest
auto_update: true
timezone: UTC
log_level: info

.env Example

ANTHROPIC_API_KEY=sk-ant-api03-...
MODEL=claude-sonnet-4-20250514
GATEWAY_PORT=3000
TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrstUVWxyz
TELEGRAM_ALLOWED_USERS=12345678,87654321
TZ=UTC

Overview 🔑 API Keys Setup