aritzmmartinez/quoin repository overview

⁠Quoin

Open-source, self-hosted portfolio tracker: allocation analysis, true look-through exposure across ETFs, time- and money-weighted returns, and Bizkaia foral tax support. Your data stays on your machine.

Source, documentation and changelog: https://github.com/aritzmmartinez/quoin⁠

⁠Run

docker run -d --name quoin -p 127.0.0.1:3000:3000 -v quoin-data:/app/data --restart unless-stopped aritzmmartinez/quoin:latest

Then open http://localhost:3000⁠.

Keep 127.0.0.1: in -p. Quoin has no login. Publishing the port on every interface exposes your portfolio to your network.

⁠Data

• The database lives in the quoin-data volume, never in the image.
• Every start applies pending migrations. When a new version brings migrations, the database is backed up first; if the backup fails, the container does not start.
• Manual backup: docker exec quoin npm run db:backup
• Copy backups off the volume: docker cp quoin:/app/data/backups ./quoin-backups

⁠Update

docker pull aritzmmartinez/quoin:latest docker rm -f quoin

Then run the same docker run again. The volume carries over.

⁠Tags

• latest — the newest release
• 0.11, 0.11.0 — pinned versions

Platforms: linux/amd64, linux/arm64 (including Raspberry Pi 4/5 and Windows on ARM).

⁠Optional

-e OPENFIGI_API_KEY=… — a free OpenFIGI key speeds up matching fund holdings by canonical identity.

License: AGPL-3.0-only.