Self-Hosting

Requirements

  • Ubuntu 22.04+ or Debian 12+ VPS
  • 2+ CPU cores, 4GB+ RAM
  • A domain pointed to your server
  • Supabase project (free tier works)

One-command install

curl -fsSL https://raw.githubusercontent.com/joeybuilt-official/pushd/main/infra/install.sh | sudo bash

The installer checks dependencies, prompts for configuration, and starts all services.

Manual install

  1. Install Docker and Docker Compose v2
  2. Clone: git clone https://github.com/joeybuilt-official/pushd.git /opt/pushd
  3. Copy .env.example to .env and configure
  4. Run: cd infra && docker compose up -d

Plexo (optional)

The installer asks whether to include Plexo. If enabled, it starts alongside Pushd. You can configure it later — Pushd works fully without it.

Updating

cd /opt/pushd && git pull && docker compose build && docker compose up -d