/dev/push

An open-source and self-hostable alternative to Vercel, Render, Netlify and the likes. It allows you to build and deploy any app (Python, Node.js, PHP, ...) with zero-downtime updates, real-time logs, team management, customizable environments and domains, etc.

Key features

• Git-based deployments: Push to deploy from GitHub with zero-downtime rollouts and instant rollback.
• Multi-language support: Python, Node.js, PHP... basically anything that can run on Docker.
• Environment management: Multiple environments with branch mapping and encrypted environment variables.
• Real-time monitoring: Live and searchable build and runtime logs.
• Team collaboration: Role-based access control with team invitations and permissions.
• Custom domains: Support for custom domain and automatic Let's Encrypt SSL certificates.
• Self-hosted and open source: Run on your own servers, MIT licensed.

Documentation

See devpu.sh/docs for installation, configuration, and usage. For technical details, see ARCHITECTURE.md.

Prerequisites

• Server: Ubuntu 20.04+ or Debian 11+ with SSH access and sudo privileges. A Hetzner CPX31 works well.
• DNS: We recommend Cloudflare.
• GitHub account: You'll create a GitHub App for login and repository access.
• Email provider: A Resend account or SMTP credentials for login emails and invitations.

Quickstart

⚠️ Supported on Ubuntu/Debian. Other distros may work but aren't officially supported (yet).

1. Install on a fresh server:

curl -fsSL https://install.devpu.sh | sudo bash

2. Create a GitHub App at devpu.sh/docs/guides/create-github-app

3. Configure by editing /var/lib/devpush/.env with: APP_HOSTNAME, DEPLOY_DOMAIN, LE_EMAIL, EMAIL_SENDER_ADDRESS, RESEND_API_KEY (or SMTP settings), and your GitHub App credentials.

4. Set DNS:

   • A example.com → server IP (app hostname)
   • A *.example.com → server IP (deployments)

5. Start the service:

sudo systemctl start devpush.service

For more information, including manual installation or updates, refer to the documentation.

Development

Prerequisites: Docker and Docker Compose v2+. On macOS, Colima works well as an alternative to Docker Desktop.

git clone https://github.com/hunvreus/devpush.git
cd devpush
mkdir -p data
cp .env.dev.example data/.env
# Edit data/.env with your GitHub App credentials

Start the stack:

./scripts/start.sh

The stack auto-detects development mode on macOS and enables hot reloading. Data is stored in ./data/.

Registry catalog

Default runner/preset definitions ship in registry/ and are copied to DATA_DIR/registry/ during install/update. See registry/README.md for the catalog format and override rules.

Key scripts:

• ./scripts/start.sh / stop.sh / restart.sh — manage the full stack or selected components (--components )
• ./scripts/compose.sh logs -f app — view logs
• ./scripts/db-generate.sh — create database migration
• ./scripts/clean.sh — remove all Docker resources and data
• ./scripts/update.sh — update by ref (defaults to app only; use --all / --components / --full to expand scope)

See ARCHITECTURE.md for codebase structure.

Scripts

Environment variables