Installation

How to install and update locally or on a server.

Quickstart

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

curl -fsSL https://raw.githubusercontent.com/hunvreus/devpush/main/scripts/prod/inst

Note: Your user must have sudo privileges.

You will need a fresh Ubuntu/Debian server you can SSH into with sudo privileges. We recommend a CPX31 from Hetzner.

You can use the provisioning script to get a server up and running:

Sign in or sign up for a Hetzner account: Hetzner Cloud Console
Generate an API token: Creating an API token
Provision a server (requires --token; optional: --user, --name, --region, --type):

curl -fsSL https://raw.githubusercontent.com/hunvreus/devpush/main/scripts/prod/p

Once you have your server ready, you can install the application using the quickstart command above.

curl -fsSL https://raw.githubusercontent.com/hunvreus/devpush/main/scripts/prod/inst | bash

To update to the latest version, run the same installation command:

curl -fsSL https://raw.githubusercontent.com/hunvreus/devpush/main/scripts/prod/inst | bash

For development setup, clone the repository and follow the setup instructions:

git clone https://github.com/hunvreus/devpush.git
cd devpush
./scripts/dev/install.sh

To update your development environment:

git pull origin main
./scripts/dev/update.sh

The installation process uses several scripts that handle different aspects of the setup:

Configure your installation using these environment variables:

export APP_NAME="My App"
export DATABASE_URL="postgresql://user:pass@localhost/db"
export SECRET_KEY="your-secret-key-here"

For GitHub integration, you'll need to set up a GitHub App:

Configure who can access your application by setting up authentication:

export ALLOWED_EMAILS="[email protected],[email protected]"
export ALLOWED_DOMAINS="example.com,company.com"