anagermano/orlanumis repository overview

⁠Orla Numis

A self-hosted catalogue for a personal collection of coins and banknotes: records with photos and catalogue references (KM, Pick, Numista), Numista lookups and values, sets and challenges such as the euro commemoratives, statistics, a wish list, duplicates to trade, PDF and Excel exports, a full backup every day, and optional AI tools (Anthropic Claude or a self-hosted Ollama). In English and European Portuguese.

One image with everything: the app and its AI agent, for linux/amd64 and linux/arm64.

Source, documentation and issues: github.com/AnaGermano6/OrlaNumis⁠.

⁠Start

docker run -d --name orlanumis --restart unless-stopped \
  -p 8080:8080 \
  -e PUID=1000 -e PGID=1000 -e TZ=Europe/Lisbon \
  -v ./data:/app/data \
  -v ./uploads:/app/uploads \
  -v ./backups:/app/backups \
  anagermano/orlanumis:latest

Open http://<this computer>:8080 and register: the first account becomes the administrator. Numista and the AI providers are set up in Admin.

With Docker Compose, use the project's docker-compose.yml⁠: docker compose up -d in its folder.

On Unraid, install OrlaNumis from Community Applications.

⁠Folders

Keep the first two together: the database points to the photos.

⁠Environment

Before reaching it from the internet, read the deployment guide⁠: HTTPS through a reverse proxy, trusted proxies, closed registration and backups.

⁠Updating

Admin → Updates says when a new version is out and what it brings. Updating keeps the data: the app migrates it when it starts on the new version.

• Docker Compose: docker compose pull && docker compose up -d
• Unraid: Docker tab, Check for Updates, then Apply Update
• docker run: pull the new image, then remove the container and create it again with the same options

With Watchtower⁠ set up (its HTTP API on), the app updates itself with one click, after a backup. The docker-compose.yml has it ready.

⁠Tags

⁠License

MIT. Based on Aurearia⁠ by Brian DeNicola.