Deployment

Your infrastructure.
Your rules.

TrackLedgr runs wherever you need it. From a single AWS command to a fully air-gapped VMware appliance — your data never has to leave your network.

Options

Four ways to deploy

All deployment options run the same codebase with the same features and security controls.

☁️
Most Popular

AWS EC2

Run a single script from your Mac. It provisions a t3.small EC2 instance, sets up nginx, configures SSL via Let's Encrypt, and starts the app with PM2. The full stack in one command.

  • Automated VPC, subnet, and security group creation
  • Elastic IP for a stable public address
  • Let's Encrypt SSL certificate — free and auto-renewing
  • PM2 process manager with auto-restart
  • UFW firewall configured automatically
  • Update script for zero-downtime code pushes
# Full AWS deployment in one command
$ bash deploy-ledgr.sh
🐳

Docker / Docker Compose

Containerised with Docker Compose. Deploy to any host that runs Docker — AWS ECS, Azure Container Instances, Google Cloud Run, DigitalOcean, or bare metal. Your ops team already knows how to manage it.

  • Single docker-compose.yml — no configuration complexity
  • Works on ECS, ACI, GCR, Kubernetes, or bare metal
  • Environment variables via .env file or secrets manager
  • Volume mounts for persistent database and uploads
  • Health check endpoint for orchestrator integration
# Start with Docker Compose
$ docker compose up -d
ledgr-app started on :3001
📦

VMware OVA Appliance

A fully packaged virtual appliance. Import the OVA into VMware vSphere or Workstation, power it on, and TrackLedgr is running. Zero external dependencies — no internet access required after first boot.

  • Import into vSphere, ESXi, or Workstation
  • Pre-configured Ubuntu base image
  • All dependencies bundled — no internet required
  • Ideal for data-centre and regulated environments
  • Persistent storage on virtual disk
# Import OVA → power on → done
No CLI required. GUI import from vSphere client.
🏛️

On-Premise / Air-Gapped

Deploy directly on your own servers with no cloud dependency. Suitable for regulated environments where data must never leave your network — finance, healthcare, government, and legal.

  • Runs on any Ubuntu 22.04 or Debian server
  • No outbound internet connections required post-setup
  • Works behind corporate firewalls and proxies
  • Data stored locally — SQLite or PostgreSQL
  • Internal DNS friendly — works on private domains
  • Suitable for HIPAA, FedRAMP, and PCI-DSS environments
# Copy files and run setup on any Linux server
$ bash setup-onprem.sh
Requirements

Lightweight by design

⚙️

Minimum Spec

2 vCPU, 2GB RAM, 20GB disk. A t3.small on AWS (~$15/month) handles hundreds of assets and users without breaking a sweat.

📦

Stack

Node.js 20 LTS backend, React frontend, SQLite database (PostgreSQL migration in progress). Served by nginx with PM2 process management.

🔧

Prerequisites

For AWS deployment: AWS CLI, Node.js, and an AWS account. For Docker: Docker and Docker Compose. For on-premise: Ubuntu 22.04 and SSH access.

Ready to Deploy

See it running before you commit

The live demo runs on AWS EC2 — exactly the same setup you'd deploy. See how it performs before writing a single config line.

View Integrations →