Warning
This release contains breaking changes that require migrations, so please read these instructions carefully if you are upgrading from a previous version, otherwise your installation will not work properly.
What changed:
🔥 Major updates
- Referrer grouping - now in the Traffic sources you will see links grouped by it's top level domain. For example, if you have many different referrers from different Reddit posts, you'll see all of them grouped by Reddit name. If you click on a top level domain - you'll see a list of all the links from this domain. Learn more.
- Annotations - You can now mark important events on your charts to remember why traffic patterns changed. Learn more.
- Added traffic exclusion by country. Learn more.
🙂 Minor changes
- New filters experience - search filters modal now allows you to filter by contains / not contains, and overall it's much easier to apply filters using this view.
- Add autorefresh (every 30 seconds) functionality to analytics dashboard.
- Show/hide toggle on password input fields.
- A few other UI improvements around the app.
🔧 Fixes
- Filter for Pages leads to crash (bug report from our Discord channel)
Upgrading to Swetrix v4.1.0 (from v4.0.6)
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 v4.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 commands in your selfhosting folder:
docker compose exec swetrix-api node migrations/clickhouse/selfhosted_2025_11_29.js
docker compose exec swetrix-api node migrations/clickhouse/selfhosted_2025_11_30.jsIf you don't see any Query ERROR messages written to your console, this indicates that the migrations went well and Swetrix v4.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! Let us know if you find any bugs or have any feedback for us and join our Discord.
Our work would not be possible without your support, and we hope you will love this release!