Liwan v1.5.0 - 2026-05-10

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

liwan-v1.4.1-rc.2

Liwan v1.4.1-rc.2

liwan-v1.4.1-rc.1

Liwan v1.4.1-rc.1

liwan-v1.4.1-rc.0

Liwan v1.4.1-rc.0

Liwan v1.4.0 - 2026-03-14

• 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.

liwan-v1.4.0-rc.3

Liwan v1.4.0-rc.3

liwan-v1.4.0-rc.2

Liwan v1.4.0-rc.2

liwan-v1.4.0-rc.1

Liwan v1.4.0-rc.1

Liwan v1.3.0 - 2025-10-12

• Updated to the latest version of DuckDB (1.4)
• Graceful shutdown on SIGINT and SIGTERM
• X86-64-v3 is now the default target architecture for x86_64 Linux builds

Liwan v1.2.1 - 2025-06-21

• Full dimension values are now shown when hovering over the dimension in the table
• Updated dependencies & switched to the upstream of DuckDB
• Now using Jemalloc as the default memory allocator for improved performance and memory usage

If you're upgrading from v1.1.0, please upgrade to Liwan v1.1.1 first.