OLogger

OLogger is an offline-first amateur radio logging application: a Go daemon that serves a Svelte SPA and API for QSO logging, sync, and enrichment.

What it is based on

• Backend: Go 1.26, Chi router, PostgreSQL, Valkey Streams, OIDC auth
• Frontend: Svelte 5 + Vite + Tailwind, Dexie (IndexedDB), service worker for offline behavior
• Data enrichment: POTA/SOTA/WWFF/CTY reference data, QRZ + HamQTH callbook integrations

Configuration

1. Copy and edit environment values:
   • Template: .env.example
   • Local runtime file: .env (for development)
2. Required values include:
   • APP_KEY
   • DATABASE_URL
   • VALKEY_URL, VALKEY_QUEUE_DB, VALKEY_CACHE_DB
   • OIDC_ISSUER_URL, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET, OIDC_REDIRECT_URL
   • SESSION_HASH_KEY, SESSION_BLOCK_KEY
3. Generate 32-byte base64 secrets with:
   • openssl rand -base64 32

How to run

1. Install dependencies:
   • Go 1.26.x
   • pnpm
   • PostgreSQL
   • Valkey/Redis-compatible server
2. Start local services (example):
   • docker-compose up -d
3. Build and run checks:
   • just build
4. Deploy the daemon to the expected user path and restart service:
   • just deploy
5. Common commands:
   • just lint
   • just check
   • just clean

License

This project is licensed under the MIT License. See LICENSE.