Pulsar
docs
← back to home

Getting Started

Deploy your first project in under 5 minutes. Pulsar Deploy connects to your GitHub repos and deploys them to your own server with a live HTTPS URL.

Prerequisites

You need a GitHub account and a server running Ubuntu 20.04+ with Docker installed. Pulsar Deploy manages everything else.

Quick Start

1
Sign in with GitHub

Click "Get started free" on the homepage. Pulsar Deploy uses GitHub OAuth — no passwords to create or remember.

2
Connect a repository

From the dashboard, click "New Project". Select a GitHub repository and branch to deploy. Pulsar automatically detects your framework (Next.js, React, Vue, Svelte, Express, FastAPI, Django, or static).

3
Configure (optional)

Pulsar auto-detects build commands, but you can override them:

Build command:    npm run build
Install command:  npm install
Output directory: .next
Branch:           main
4
Deploy

Click "Deploy" or push to your configured branch. Pulsar clones the repo, builds via Nixpacks, provisions a Docker container, configures nginx, and provisions SSL — all in under 60 seconds.

5
Go live

Your project gets a live HTTPS URL immediately. Add a custom domain from the project settings, and SSL is auto-provisioned via Certbot.

What happens during a deploy

1. GitHub webhook triggers (or manual deploy)
2. Repo cloned at specified branch/commit
3. Framework detected via Nixpacks
4. Dependencies installed, project built
5. Docker container created with allocated port
6. Nginx reverse proxy configured
7. SSL certificate provisioned (Certbot)
8. Health check passes → deployment marked "live"
9. Previous container kept for instant rollback

Next steps

Set up environment variables, connect a custom domain, or explore managed databases.