Getting-started

Configuring your application

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

Pledger.io uses environment variables to configure the application.

General configuration options  

VariableDescriptionDefault
DB_TYPEThe type of database to use, allowed are h2 or mysqlh2
MICRONAUT_ENVIRONMENTSComma-separated Micronaut environment profiles, for example h2,jpa or mysql,jpa. The Docker image normally sets this for you based on DB_TYPE.-
MICRONAUT_APPLICATION_STORAGE_LOCATIONDirectory used for uploaded and generated files. Mount a volume here to keep data across container restarts.JVM temp directory

  Note

The backend also ships a PostgreSQL profile (psql). Advanced setups can activate it directly with MICRONAUT_ENVIRONMENTS=jpa,psql instead of using DB_TYPE.

MySQL configuration options  

If the database type is set to mysql then the following environment variables are used.

VariableDescriptionDefault
DATABASE_HOSTThe MySQL server hostlocalhost
DATABASE_PORTThe MySQL server port3306
DATABASE_SCHEMAThe MySQL schema to usefintrack
DATABASE_USERThe MySQL user for authenticationfintrack
DATABASE_PASSWORDThe MySQL password for authenticationfintrack

Mail configuration options  

Mail is disabled by default (a mock mail sender is used). To enable real mail delivery, activate the smtp environment profile, for example MICRONAUT_ENVIRONMENTS=h2,jpa,smtp, and configure the following variables.

VariableDescriptionDefault
SMTP_HOSTThe SMTP server host-
SMTP_USERThe SMTP user for authentication-
SMTP_PASSWORDThe SMTP password for authentication-

The connection uses port 587 with STARTTLS.

OpenID configuration options  

When you want to enable OpenID connect in Pledger.io you will have to configure the following settings.

VariableDescriptionDefault
OPENID_URIThe URI to the certificate location for the Realm in OpenID-
OPENID_SECRETThe secret for the client-
OPENID_AUTHORITYThe URI to the realm-
OPENID_CLIENTThe client identifierpledger-io

Large Language Model options  

When either using the docker image ghcr.io/pledger-io/amd64-embedded-llm you can configure the following options. Alternatively you can use the normal image but use OpenAI, at the cost of some privacy.

VariableDescriptionDefault
AI_ENGINEThe engine to use. Supported are ollama and open-aiollama
AI_MODELThe Ollama model to use, only used with AI_ENGINE ollamaqwen3:4b
AI_TEMPERATUREControls the creativity of the model, between 0 (predictable) and 1 (creative)0.7
APPLICATION_AI_OLLAMA_URIThe URI of the Ollama server, only used with AI_ENGINE ollamahttp://localhost:11434
OPENAI_TOKENThe application token for OpenAI, must be set when AI_ENGINE is open-ai-
Last modified on November 8, 2026 Edit this page on GitHub