Deploy Formance Ledger on Your Own Server
Programmable Financial Ledger To Build Money-Moving Applications
Want to deploy Formance Ledger on your server faster? Try Senate with one-command setup, automatic HTTPS and monitoring.
What is Formance Ledger?
Formance Ledger lets you model and record complex money movements, helping you accelerate your business operations. Build financial dashboards, deliver payments to your marketplace partners, and accurately track revenue across your entire operation.
Self-Host Formance Ledger
Follow these steps to deploy on your own server.
Install Docker
Skip this step if Docker is already installed on your server.
curl -fsSL https://get.docker.com | sh
Configure
Customize the settings below. Defaults work for most cases.
Application
Database
Deploy
Copy the configuration and run it on your server.
services:
formance_ledger:
image: ghcr.io/formancehq/ledger:v1.8.0
environment:
NUMARY_AUTH_BASIC_CREDENTIALS: f8e093b464778673
NUMARY_AUTH_BASIC_ENABLED: "true"
NUMARY_SEGMENT_ENABLED: "false"
NUMARY_SERVER_HTTP_BIND_ADDRESS: 0.0.0.0:3068
NUMARY_STORAGE_DRIVER: postgres
NUMARY_STORAGE_POSTGRES_CONN_STRING: postgresql://formance:12e6dbd3675c6c53@formance_ledger-db/formance
volumes:
- formance_ledger:/root/.numary
depends_on:
- formance_ledger-db
formance_ledger-db:
image: postgres:14.0-alpine
environment:
POSTGRES_DB: formance
POSTGRES_PASSWORD: 12e6dbd3675c6c53
POSTGRES_USER: formance
volumes:
- formance_ledger-db:/var/lib/postgresql/data
formance_ledger-ui:
environment:
NUMARY_UI_HTTP_BIND_ADDRESS: 0.0.0.0:3078
depends_on:
- formance_ledger
volumes:
formance_ledger: {}
formance_ledger-db: {}
Then run:
docker compose up -d
Access
Once started, access your app at http://localhost:3068
Why Self-Host Formance Ledger?
Full Data Ownership
Your data stays on your servers. No third-party access.
No Monthly Fees
Pay only for your server. No per-seat or usage charges.
Complete Control
Customize, backup, and scale on your own terms.
Privacy & Compliance
Meet GDPR, HIPAA, or internal security requirements.
Technical Details
Docker Image
ghcr.io/formancehq/ledger:${FORMANCE_LEDGER_VERSION}Official Docs
docs.formance.comWant to go faster?
Try Senate! Senate handles Docker, HTTPS, updates, and monitoring for you. Deploy any of our 300+ apps with a single command.
Install on any Linux server:
sh -c "$(curl -sSL https://get.senate.sh)"