Deploy TamperTrail

Deploy your own mathematically proven audit infrastructure in minutes. Zero third-party trust required.

PREREQUISITES

🐳
Docker Desktop
Install from docs.docker.com →
🔌
Port 80 Available
No other service on port 80
💾
~2 GB Disk Space
For Docker images + database

01. Clone the Repository

Pull the raw docker-compose orchestration straight from the main branch.

bash
git clone https://github.com/sthakur369/TamperTrail.git
cd TamperTrail

02. Initialize Environment

Set up your config. TamperTrail natively auto-generates your database passwords, JWT secrets, and Fernet AES-128 encryption keys. Zero manual secrets to manage.

bash
cp .env.example .env

03. Start TamperTrail

Ensure Port 80 is available. Starts the Nginx Reverse Proxy, FastAPI Server, and PostgreSQL database.

bash
docker compose up -d --build

04. Complete Secure Setup

Navigate to http://localhost — you'll see the Setup Wizard. Create your master admin password (8+ characters) and click Complete Setup. All routes are locked until this step is done.

What just got installed?

Three Docker containers spin up — Nginx, FastAPI, and PostgreSQL. Only port 80 is exposed to the outside world. Everything else communicates over an internal Docker network.

View Architecture Diagram →
Full container breakdown, internal network topology, storage volumes, and security boundaries.

05. Instrument your Application

Now that your vault is running, you can start streaming logs to it. TamperTrail exposes a standard REST API — any language or runtime that can make an HTTP request works out of the box.

Open Integration GuideView Python SDK on GitHub

06. Updating TamperTrail

To pull the latest security patches and features without losing any data:

# 1. Pull the latest images
docker compose pull
# 2. Stop containers (data is safe in volumes)
docker compose down
# 3. Start fresh with new images
docker compose up -d
# 4. Free up old image layers
docker image prune -f
🔔

Stay up to date — Watch our repository for new releases. Click Watch → Custom → Releases in the top-right corner of the repo to get notified when security patches and new features drop.