Installation

You have three ways to install Postgresus: automated script (recommended), simple Docker run or Docker Compose setup.

System requirements

Postgresus requires the following minimum system resources to run properly:

  • CPU: At least 1 CPU cores
  • RAM: Minimum 500 MB RAM
  • Storage: 5 GB for installation and as much as you need for backups
  • Docker: Docker Engine 20.10+ and Docker Compose v2.0+

Option 1: installation script (recommended, Linux only)

The installation script will:

  • ✅ Install Docker with Docker Compose (if not already installed)
  • ✅ Set up Postgresus
  • ✅ Configure automatic startup on system reboot
sudo apt-get install -y curl && \
sudo curl -sSL https://raw.githubusercontent.com/RostislavDugin/postgresus/refs/heads/main/install-postgresus.sh | sudo bash

In this case Postgresus will be installed in /opt/postgresus directory.

Option 2: Simple Docker run

The easiest way to run Postgresus:

docker run -d \
  --name postgresus \
  -p 4005:4005 \
  -v ./postgresus-data:/postgresus-data \
  --restart unless-stopped \
  rostislavdugin/postgresus:latest

This single command will:

  • ✅ Start Postgresus
  • ✅ Store all data in ./postgresus-data directory
  • ✅ Automatically restart on system reboot

Option 3: Docker Compose setup

Create a docker-compose.yml file with the following configuration:

services:
  postgresus:
    container_name: postgresus
    image: rostislavdugin/postgresus:latest
    ports:
      - "4005:4005"
    volumes:
      - ./postgresus-data:/postgresus-data
    restart: unless-stopped

Then run:

docker compose up -d

Keep in mind that start up can take up to ~2 minutes.

Getting started

After installation:

  1. Launch and access Postgresus: Start Postgresus and navigate to http://localhost:4005
  2. Create your first backup job: Click "New Backup" and configure your PostgreSQL database connection
  3. Configure schedule: Set up your backup schedule (hourly, daily, weekly or monthly)
  4. Choose storage destination: Select where to store your backups (local, S3, Google Drive, etc.)
  5. Set up notifications: Add notification channels (Slack, Telegram, Discord) to get alerts about backup status
  6. Start backing up: Save your configuration and watch your first backup run!

How to update Postgresus?

To update Postgresus, you need to stop it, clean up Docker cache and restart the container.

  1. Go to the directory where Postgresus is installed (usually /opt/postgresus)
  2. Stop the container: docker compose stop
  3. Clean up Docker cache: docker system prune -a
  4. Restart the container: docker compose up -d

It will get the latest version of Postgresus from the Docker Hub (if you have not fixed the version in the docker-compose.yml file).

Troubleshooting

Container won't start

If the container fails to start, check the logs:

docker logs postgresus

Port already in use

If port 4005 is already in use, you can change it in your docker-compose.yml:

ports:
  - "8080:4005" # Change 8080 to any available port

Permission denied errors

If you encounter permission issues with the data directory:

sudo chown -R $USER:$USER ./postgresus-data
chmod -R 755 ./postgresus-data