Warning
This release contains breaking changes that require migrations and changes to your configuration, please read these instructions carefully if you are upgrading from a previous version, otherwise your installation will not work properly.
🔥 Major updates
🙂 Minor changes
- Improve onboarding & empty projects pages - now you will see a block with detailed info & links on how to add tracking to your website
- Add top 1/3/5/10 dropdown to the custom events chart to reduce noise
- 'Today' period chart now includes the whole day till 23:00, not just the period from the start of the day until now
- Add more integrations guides with different platforms to the docs
- Relax custom event limitations - now you can track any string up to 256 chars (before this change custom events were limited to letters & numbers only)
- App is crashing when you go offline. As a temporary solution, instead of the scary crash page it now displays a "No internet connection" page
- Session pageflow > Mark live sessions as "Session in progress" for more clarity
- Increase account max password length to 72 chars
- Dark theme & UI components improvements
🔧 Fixes
- fix: ECONNREFUSED when trying to use Swetrix CE on localhost deployments
- fix: Changing period does not update sessions in the profile view
- fix: Sometimes ALL annotations were always visible when the 'Today' period is selected, even if they're outside of that timeframe
- fix: Session & Profile detals are not displaying locale, UTM, region & city data properly
- fix: Don't expose CAPTCHA secret key on public projects
- fix: When custom event filter is applied, sometimes you might see data like UTM metrics as
nullrows - fix: Filters > Page selector is extremely laggy if there are a lot of pages present
- chore: Update dependencies
Upgrading to Swetrix v5.1 (from v5.0.3)
Important
You will need to perform a database migration. Please make sure you read these instructions through to the end to make sure you've updated properly and to avoid losing any data.
1. Run database migration scripts
Warning
Please make sure you always back up your data! Especially before migrating, to prevent data loss if something goes wrong.
In order to upgrade to Swetrix v5.1.0, you will need to run database migrations scripts. But first, your compose.yaml file should be set to the latest Swetrix versions and they are already installed on your machine.
To perform the migrations, you need to run the following command in your selfhosting folder:
docker compose exec swetrix-api node migrations/clickhouse/selfhosted_2026_03_04_2fa.jsIf you don't see any Query ERROR messages written to your console, this indicates that the migrations went well and Swetrix v5.1.0 is ready to use.
After performing the migration, you can run docker compose restart and Swetrix should be good to go!
🎉 That's it, enjoy selfhosting Swetrix! Join our Discord community for more updates & discussions about Swetrix.