Getting Started

Get Basepod running in minutes.

Supported Platforms

• macOS (M series) - Full features including local LLMs
• macOS (Intel) - App hosting only
• Linux VPS - App hosting on Hetzner, DigitalOcean, Linode, etc.

Quick Install

Server

Install Basepod on your Mac Mini or Linux VPS:

curl -fsSL https://pod.base.al/install | bash

This installs:

• basepod server daemon
• Podman (container runtime)
• Caddy (reverse proxy)
• SQLite database

CLI

Install the bp command-line tool on your local machine:

curl -fsSL https://pod.base.al/cli | bash

Or download manually:

macOS (Apple Silicon)

curl -fsSL https://github.com/base-go/basepod/releases/latest/download/bp-darwin-arm64 \
  -o /usr/local/bin/bp && chmod +x /usr/local/bin/bp

macOS (Intel)

curl -fsSL https://github.com/base-go/basepod/releases/latest/download/bp-darwin-amd64 \
  -o /usr/local/bin/bp && chmod +x /usr/local/bin/bp

Linux (AMD64)

curl -fsSL https://github.com/base-go/basepod/releases/latest/download/bp-linux-amd64 \
  -o /usr/local/bin/bp && chmod +x /usr/local/bin/bp

Linux (ARM64)

curl -fsSL https://github.com/base-go/basepod/releases/latest/download/bp-linux-arm64 \
  -o /usr/local/bin/bp && chmod +x /usr/local/bin/bp

Connect to Your Server

Login to your Basepod server:

bp login your-server.com

You'll be prompted for the admin password (shown during server installation).

Deploy Your First App

Create and deploy an app:

# Initialize your project
cd myapp
bp init

# Deploy
bp push

Your app will be live at https://myapp.your-server.com

What's Next?

• Server Setup - Detailed server configuration
• Your First App - Step-by-step deployment guide
• Templates - Deploy pre-configured apps
• MLX Models - Run local LLMs