Release 2026.06.0

If you are running any version of KOsync before 2026.05.0, you MUST update to 2026.05.0 first!
Do NOT update from before 2026.05.0 to this version (2026.06.0), otherwise you will have an empty database.

Added

• Extensive Debug Logging
• Write to Logfile and Logfile path settings
• Experimental WebSocket API with RPC and PubSub
• WebUI updates automatically upon progress sync (PubSub)
• JSON Web Tokens for Authorization: Bearer
• New Environment Variables:
  • LOG_TO_FILE: Enable writing logs to a file.
  • LOG_FILE: Path to the log file (defaults to ./kosync.log)
  • ENABLE_WEBSOCKET_API: Enable WebSocket API for WebUI (RPC/PubSub)
  • PRINT_CRYPTO_KEYS: Print JWT Keys in PEM format at startup
  • CRYPTO_KEYS_SEED: 32-Character Seed for JWT Keys (will be random if unset or empty)
  • JWT_DURATION: JWT validity duration in seconds (defaults to 6 hours)
• Automatic backups before applying migrations
• --restore Argument to restore the database (see doc/backup.md for details)

Changed

• Migrated to Fiber v3
• Updated Go to 1.25.7
• Updated Bun to 1.3.9
• Updated dependencies
• last_read_at is now a float for sub-seconds
• WebUI uses JWT instead of username+password_hash
• WebUI login is time-bound. JWT's expire after JWT_DURATION seconds AND after KOsync restart (unless a CRYPTO_KEYS_SEED is set)
• BREAKING: Environment Variables have been renamed:
  • ENABLE_IP_VALIDATION -> PROXY_IP_VALIDATION
• BREAKING: The docker image no uses 1000:1000 as user instead of root:root

Removed

• BREAKING: Migration from database.json to kosync.db

Fixed

• Unique constraint dead-lock between documents and document_history with multiple causes

Docker Image
docker.obth.eu/atjontv/kosync:2026.06.0