Configuration
Environment variables
| Name |
Default |
Required |
Comments |
| SALT |
(none) |
Yes |
Once this is set, do not ever change it. |
| DB_PATH |
(none) |
Yes |
A full postgres JDBC connection url. Example: jdbc:postgresql://localhost:5432/sss |
| DB_USER |
(none) |
Yes |
|
| DB_PASSWORD |
(none) |
Yes |
|
| TIMEZONE |
(none) |
Yes |
The timezone of the server (ex: Europe/Paris) from the tz database |
| ALLOW_SIGNUP |
0 |
No |
1 = allow signups, 0 = Do not allow signups |
| ANNOUNCEMENT_MESSAGE |
(none) |
No |
Show a message on the login screen, ex: ANNOUNCEMENT_MESSAGE="Welcome to my SpendSpentSpent instance". See demo instance to see what it looks like |
| FILES_PATH |
./files |
No |
Where to store the pictures uploaded by the users |
Email
SMTP environment variables are necessary if you want to enable the forgot password function and recurring expense
notification emails.
| Name |
Default |
Required (based on if you want SMTP services enabled) |
Comments |
| ROOT_URL |
http://localhost:8080 |
No |
The base URL used in the links in email sent to users |
| SMTP_HOST |
(none) |
Yes |
|
| SMTP_PORT |
0 |
Yes |
|
| SMTP_USERNAME |
(none) |
No |
|
| SMTP_PASSWORD |
(none) |
No |
|
| SMTP_FROM |
(none) |
Yes |
Who will be the sender of the email |
| SMTP_TRANSPORT_STRATEGY |
SMTP |
Yes |
Possible values: SMTP, SMTPS, SMTP_TLS |
AI (ollama / openai)
SSS supports analyzing images using ollama or open ai (or a compatible server) to find prices or tags about images
attached to an expense.
The default models tested well with a RX6600XT GPU (8GB VRAM).
| Name |
Default |
Comments |
| OLLAMA_API_URL |
(none) |
The url of the ollama instance. Do not use together with OPENAI_API_URL |
| OLLAMA_API_KEY |
(none) |
API Key to talk to the ollama server |
| OPENAI_API_URL |
(none) |
The url of the open ai compatible instance. Do not use together with OPENAI_API_URL |
| OPENAI_API_KEY |
(none) |
API Key to talk to the open ai compatible server |
| AI_VISION_MODEL |
qwen2.5vl:7b |
Which vision model to use. This model will be used to generate picture description |
| AI_TEXT_MODEL |
qwen3:8b |
Which text model to use. This model will take the description and generate tags and find the best expense category for a picture |
OIDC
SSS Supports SSO by implementing OIDC. You will need to set up your OIDC client as a Public Client and enable PKCE.
Here are the used callback urls:
com.spendspentspent.app:/oidcRedirect
https://your.spendspentsspent-domain.com/redirect.html
| Name |
Default |
Required |
Comments |
| OIDC_DISCOVERY_URL |
(none) |
Yes |
The discovery URL of your OIDC provider https://id.example.com/.well-known/openid-configuration |
| OIDC_CLIENT_ID |
(none) |
Yes |
Your OIDC client id |
| OIDC_AUTO_SIGNUP_USERS |
false |
No |
Whether to automatically sign up unknown users |
| OIDC_NAME |
SSO |
no |
Name of your provider to display on the UI |