liwan releases

Features

• Added new trusted_headers, trusted_proxies, and use_forward_headers config options
• Added new entry page and exit page dimensions
• Added new screen width and orientation dimensions
• New timezone-aware graphs with improved accuracy

Bug Fixes

• Fixed error when both listen and port config options are set
• Added retry logic when opening the DuckDB database to handle potential locking issues on startup (e.g. when the database is being updated by another process or when using a shared network drive)
• Fixed an issue where users with invalid session tokens would show up in the UI as logged in

Other

• Events are now rate-limited to 2 per second (with a burst of up to 10)
• Added ?ref / ?referrer / ?source as fallbacks for UTM source
• UTM parameters are now extracted on the server side
• Updated to the latest version of DuckDB (1.5.2)
• Improved filtering out invalid referrers
• Improved world map rendering & graph for bounce rate metric
• Improved UI error messages / loading states

• Updated to the latest version of DuckDB (1.5)
• GeoIP database now automatically reloads if it has been updated on disk / fixed an issue where the GeoIP database would not be updated on the first boot
• Switched to using axum as the web framework and ua-parser for user-agent parsing
• Added new listen configuration option to specify the address and port to listen on (can be a socket address or just a port number). The old port option is still supported for backwards compatibility.
• Some small UI improvements and optimizations
• Container image is now based on distroless

⚠️ The container now runs as a non-root user (UID 1000)!
If you map a folder to /data and encounter permission issues, ensure it’s owned by UID 1000 (e.g. chown 1000:1000 ./data) or has appropriate permissions (e.g. chmod 777 ./data). You can also override the UID used by Liwan when starting the container by setting the --user flag (e.g. docker run --user 0 ... to keep the old behavior).

If you're having issues with WAL replay failures, you can use version 1.4.1-rc.0 which includes DuckDB 1.5.1.