Getting-started

Installation

Install Pledger.io with Docker, Compose, Kubernetes, or Windows.
How Pledger.io runs   Next steps  

Pledger.io is a self-hosted web application. No matter which installation method you choose, the runtime model is the same:

  • A Pledger.io application process (or container) serves the web UI and API.
  • Persistent storage is used for logs and uploaded files.
  • A database stores your financial data (MySQL/MariaDB for most production setups, H2 for local/single-user scenarios).
Docker installation thumbnailIllustration for running Pledger.io with Docker.docker runRun Pledger.io with Docker

Using Docker

Run Pledger.io in a single Docker container with supported image tags.

Docker Compose installation thumbnailIllustration for deploying Pledger.io with Docker Compose.Deploy with Docker Compose

Docker compose

Deploy Pledger.io with Docker Compose, including database and volumes.

Kubernetes installation thumbnailIllustration for deploying Pledger.io on Kubernetes.Deploy on Kubernetes

With Kubernetes

Deploy Pledger.io as a Kubernetes deployment with a service.

Windows installation thumbnailIllustration for installing the Pledger.io Windows application.Install on Windows

Windows Application

Install the experimental standalone Pledger.io app for Windows 10.

Configuration thumbnailIllustration for configuring Pledger.io environment settings.Configure your application

Configuring your application

Tune database, mail, and optional AI settings with environment variables.

How Pledger.io runs  

At startup, Pledger.io connects to the configured database and applies schema migrations. After that, the application serves:

  • The web interface in your browser.
  • The REST API used by the UI and integrations.
  • Background processes such as scheduled and import-related tasks.

In container-based setups, make sure volumes are configured so logs and uploads survive restarts. For production usage, prefer a dedicated MySQL/MariaDB database and regular backups.

Next steps  

  1. Open one of the installation guides above and complete the setup.
  2. Review Configuration to tune database, mail, and optional AI settings.
  3. Continue with First steps to create your first user, accounts, and transactions.
Last modified on July 4, 2026 Edit this page on GitHub
On this page: