Installation Guide

Install PulseDB

Get your modern PostgreSQL studio up and running in minutes. Follow our step-by-step guide to deploy with zero configuration.

Step 1Install Docker Engine

PulseDB ships as a Docker container. Install Docker Desktop on Windows/macOS, or the Docker Engine on Linux.

Linux (Ubuntu / Debian)

terminal — install docker
$curl -fsSL https://get.docker.com -o get-docker.sh
$sudo sh get-docker.sh

Windows / macOS

Install Docker Desktop and open it once. No terminal commands needed.

Verify installation

check versions
$docker --version
$docker compose version

Tip: after installing on Linux, run sudo usermod -aG docker $USER and log out/in so Docker runs without sudo.

Step 2Clone the repository

Download the PulseDB source code and open the project folder. Requires git.

terminal
$git clone https://github.com/elmoziml/pulsedb.git
$cd pulsedb

Step 3Start the application

The first start builds the Docker image (takes a minute or two) then launches PulseDB in the background. Data lives in a volume, so it survives restarts.

start pulsedb
$docker compose up -d
Want to watch the logs live? Run docker compose logs -f

Step 4Open PulseDB

Create your first PostgreSQL connection, then browse tables, run queries, and manage your database — all from the browser.

Step 5Update PulseDB

When a new version is released, pull the latest code and rebuild. Your connections and encryption key are preserved in the Docker volume.

update
# Step 1 — pull the latest code
$git pull
# Step 2 — rebuild and restart
$docker compose up -d --build