Skip to Content
Coinio

Configuration

Environment variables, port and data folder.

Coinio is configured with environment variables. Everything else (currency, time zone, language, reminder time, appearance) is set in the app and stored in the database. An empty variable counts as not set.

VariableDefaultWhat it does
COINIO_PUBLIC_URLnot setThe https address you reach Coinio at, for example https://coinio.example.com. Turns on OAuth for remote MCP clients and secure session cookies. Must be https:// (or http://localhost); with an http:// address OAuth stays off.
COINIO_TELEGRAM_BOT_TOKENnot setTelegram bot token. Overrides the token saved in Settings › Notifications.
COINIO_TELEGRAM_CHAT_IDnot setTelegram chat ID. Overrides the one saved in the app.
PORT8080Port the server listens on inside the container.
COINIO_DATA_DIR/dataFolder for the database (coinio.db) and logos (logos/).
COINIO_WEB_DIRbuilt-inFolder with the built web app. Only useful for development; the image ships with it.

The image sets PORT=8080 and COINIO_DATA_DIR=/data. Leave both alone in Docker: to use another port, change the published port (-p 9000:8080), and to keep data elsewhere, mount another volume or folder at /data.

The data folder

/data
├── coinio.db        # SQLite database (WAL mode)
├── coinio.db-wal
├── coinio.db-shm
└── logos/           # downloaded and uploaded logos

Everything is here: subscriptions, payments, settings, the account, API keys and OAuth clients. The container runs as user node (UID 1000), so the folder must be writable by UID 1000. See backup and restore.

Outgoing connections

Coinio works without internet access, with fewer features. It connects out only for:

HostFor
api.frankfurter.devDaily exchange rates.
api.telegram.orgReminders, when configured.
The websites of your subscriptions, t1.gstatic.com, icons.duckduckgo.comLogos.

There is no telemetry and no update check.

Edit on GitHub

On this page