Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation#

PosternProxy installs directly on Debian 11/12 or Ubuntu 22.04/24.04. No Docker required.

Prerequisites#

A fresh Debian or Ubuntu server with root access
Ports 80, 443, and 81 open in your firewall
A domain or IP for the management UI

Automated install#

The install script handles everything: building Caddy with required plugins, creating system users, configuring systemd, UFW, fail2ban, and unattended-upgrades.

Step 1 — Build the binary

On your development machine (or CI), run:

Quick Start

Mon, 01 Jan 0001 00:00:00 +0000

Quick Start#

This guide walks you through the most common first-day tasks after installation.

1. Log in and change the default password#

Open http://<server-ip>:81 in your browser.

On first boot, PosternProxy generates a random admin password and prints it to the service logs. Retrieve it before logging in:

journalctl -u posternproxy --no-pager | grep -A5 "INITIAL SETUP"

Email: admin@posternproxy.local (or the value of POSTERNPROXY_ADMIN_EMAIL)
Password: the generated password from the startup banner above

Immediately navigate to Users → (your account) → Change Password and set a strong password.