Quick Start

Get Basepod running in minutes.

Supported Platforms

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

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

Connect to Your Server

bp login bp.example.com

Enter the admin password (shown during server installation).

Deploy Your First App

# Go to your project
cd myapp

# Initialize config
bp init

# Deploy
bp deploy

Your app is live at https://myapp.example.com

Common Workflows

Deploy a Static Site

npm run build
bp init          # Select: Static site
bp deploy

Deploy a Node.js App

bp init          # Detects package.json
bp deploy

Deploy from Docker Image

bp deploy --image nginx:latest

Deploy One-Click Template

bp template deploy postgres -e POSTGRES_PASSWORD=secret

Run Local LLM (Apple Silicon)

bp model pull Llama-3.2-3B
bp model run Llama-3.2-3B
bp chat

What's Next?

• CLI Reference - All commands
• Static Sites - Deploy static sites
• Container Apps - Deploy with Docker
• Templates - One-click apps
• Local LLMs - Run AI models