HELP & COMMUNITY SUPPORT
Which product or platform
do you need assistance with?
Select your platform below to view diagnostic paths, common troubleshooting steps, and direct links to our community forums and GitHub issue trackers.
Troubleshooting & Support for Desktop (Windows, macOS, Linux)
Native Flutter desktop client with local SQLite storage, full multi-column customization, and offline independence.
Database & Diagnostic Log Paths
If you encounter an issue, locating your logs and database folder is the quickest way to get help:
- Windows:
%APPDATA%\Collectarr\logs\%APPDATA%\Collectarr\database\ - macOS:
~/Library/Application Support/Collectarr/logs/ - Linux:
~/.local/share/collectarr/logs/
💡 You can also view live logs inside the application under Settings → Logs.
Common Desktop Solutions
- Backups before changes: Collectarr automatically creates daily database copies. Restore or verify them in Settings → Data.
- Imports & Exports: CLZ Web XML files and CSV/TXT files can be imported directly via Main Menu → Import Data.
- Keyboard shortcuts: Press Ctrl+K (or Cmd+K) for instant search; F1 opens the User Manual.
- Display & Theme: Switch between Dark and Default theme in Settings → Appearance.
Troubleshooting & Support for Mobile (iOS & Android)
Designed for browsing in the record store or game shop, scanning barcodes, and on-the-go collection updates.
Diagnostic Information
To inspect your build version or retrieve diagnostics on your mobile device:
- App Version: Open Settings → About to find the full version string and build commit.
- Logs: View current session logs under Settings → Logs. Tap "Copy to clipboard" to share in a discussion.
- Barcode scanner: Ensure camera permissions are enabled in your phone's system Settings under Collectarr.
Common Mobile Solutions
- Barcode scanning focus: Keep barcodes flat and well-lit. Collectarr supports both 1D UPC/EAN barcodes and 2D codes.
- Syncing with self-hosted Core: Ensure your mobile device is on the same local Wi-Fi network, or use a secure HTTPS reverse proxy.
- Offline mode: All cached items, custom fields, and local photos remain accessible without an active internet connection.
Troubleshooting & Support for Collectarr Web (Browser & Docker)
Accessible in any modern desktop or tablet browser. Self-hostable with the official Docker container.
Browser Diagnostics
For web browser issues, the browser developer tools reveal network and runtime errors:
- Browser Console: Press F12 (or right click → Inspect) and open the Console tab to view JavaScript warnings or errors.
- Network tab: Check whether API calls to your Core catalog or Sync server report 403, 404, or CORS headers.
- Browser Storage: Stored locally using IndexedDB. Check Application → IndexedDB in developer tools.
Self-Hosting & Docker Tips
- Container health: Check container logs with
docker logs collectarr-web. - CORS origin: When connecting the web UI to
collectarr-core, ensure the Core server's allowed origins include your web origin. - Hard refresh: If a new release has been deployed, force refresh the browser with Ctrl+F5 (or Cmd+Shift+R).
BY COLLECTION KIND
Kind-Specific Support Forums
Have questions about a specific media format, fields, or catalog metadata? Join the right discussion board:
Collectarr Music Forum
Vinyl dead-wax matrices, optical audio discs, Discogs imports, contributor credits, and track metadata.
Collectarr Games Forum
Video game platforms, Loose/CIB completeness tiers, console hardware serials, and toys-to-life figures.
Before posting logs or screenshots
Collectarr support discussions and GitHub issue trackers are public. Never post passwords, API tokens, live production database files, or personal private details. Sanitize screenshots and remove personal identifiers before submitting.