Getting Started on PosternProxy Documentation

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: installing the bundled Caddy, creating system users, configuring systemd, UFW, fail2ban, and unattended-upgrades.

Step 1 — Download the release binaries

Download the latest release from the GitHub releases page. Each release provides three binaries for your server’s architecture (amd64 for most servers, arm64 for ARM):

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 its log file. Retrieve it before logging in:

grep -A6 "INITIAL SETUP" /var/log/posternproxy/posternproxy.log

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.

Building from Source

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

Building from Source#

Pre-built binaries are published on the GitHub releases page and are the recommended way to install — see Installation. Build from source only if you want to run unreleased changes or target an architecture that isn’t published.

Build on a development machine or CI, not on the production server — this keeps the Go toolchain off production. The build produces three Linux binaries:

Binary	Purpose
`posternproxy`	The controller (management UI + API, with the frontend embedded)
`posternproxy-agent`	The remote agent
`caddy`	A custom Caddy build with the L4 and rate-limit plugins

Requirements: Go 1.25+ and Node.js 20+ (with npm).