Repository files navigation

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.

• 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.

• Server: Ubuntu 20.04+ or Debian 11+ with SSH access and sudo privileges. AHetzner CPX31 works well.
• DNS: We recommendCloudflare.
• GitHub account: You'll create a GitHub App for login and repository access.
• Email provider: AResend account for login emails and invitations.

⚠️ 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 atdevpu.sh/docs/guides/create-github-app

3. Configure by editing/var/lib/devpush/.env with your GitHub App credentials and domains.

4. Set DNS:

   • Aexample.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 tothe documentation.

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

git clone https://github.com/hunvreus/devpush.gitcd devpushmkdir -p datacp .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/.

Key scripts:

• ./scripts/start.sh /stop.sh /restart.sh — manage the stack
• ./scripts/compose.sh logs -f app — view logs
• ./scripts/db-generate.sh — create database migration
• ./scripts/clean.sh — remove all Docker resources and data

SeeARCHITECTURE.md for codebase structure.

Seedevpu.sh/docs for installation, configuration, and usage. For technical details, seeARCHITECTURE.md.

• Contribute code
• Report issues
• Sponsor me
• Star the project on GitHub
• Join the Discord chat

MIT