Releases · plausible/analytics

03 Feb 12:00

v2.1.5

cb57616

v2.1.5 Latest

Latest

This release focuses on enhancing email functionality, including improved error logging, the addition of plain text emails, and the removal of trial and billing-related messaging in the Community Edition.

Upgrade

Update the image used for plausible

_compose.yml

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.4
+ image: ghcr.io/plausible/community-edition:v2.1.5

and restart the containers

_console

$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.4:

Added

Add text version to emails #4674
Add error logging when email delivery fails #4885

Removed

Remove Plausible Cloud contacts #4766
Remove trial mentions #4668
Remove billings and upgrade tabs from settings #4897

Assets 2

0 Join discussion

20 Jan 15:11

ruslandoga

v2.1.5-rc.4

cb57616

v2.1.5-rc.4 Pre-release

Pre-release

Upgrade

Update the image used for plausible

_compose.yml

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.4
+ image: ghcr.io/plausible/community-edition:v2.1.5-rc.4

and restart the containers

_console

$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.4:

Added

Add text version to emails #4674
Add error logging when email delivery fails #4885

Removed

Remove Plausible Cloud contacts #4766
Remove trial mentions #4668
Remove billings and upgrade tabs from settings #4897

Assets 2

1 Join discussion

17 Jan 12:58

ruslandoga

v2.1.5-rc.1

8a8b1db

v2.1.5-rc.1 Pre-release

Pre-release

Upgrade

Update the image used for plausible

_compose.yml

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.4
+ image: ghcr.io/plausible/community-edition:v2.1.5-rc.1

and restart the containers

_console

$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.4:

Added

Add text version to emails #4674
Add error logging when email delivery fails #4885

Removed

Remove Plausible Cloud contacts #4766
Remove trial mentions #4668
Remove billings and upgrade tabs from settings #4897

Assets 2

6 Join discussion

09 Oct 09:49

ruslandoga

v2.1.4

5fec52a

v2.1.4

This is a patch release focused on resolving file moving issue with CSV export/import, alongside several other improvements to enhance the user experience.

Upgrade

Update the image used for plausible

_{docker-compose.yml}

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.3
+ image: ghcr.io/plausible/community-edition:v2.1.4

and restart the containers

_console

$ cd hosting
$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.3:

Added

Add ability to review and revoke particular logged in user sessions
Add ability to change password from user settings screen
Add error logs for background jobs #4657

Changed

Revised User Settings UI
Default to invite_only for registration #4616

Fixed

Fix cross-device file move in CSV exports/imports #4640

Assets 2

9 Join discussion

26 Sep 11:18

ruslandoga

v2.1.3

cb365c2

v2.1.3

This release is the same as v2.1.2 but with cookie and filters issues resolved.

Upgrade

Update the image used for plausible

_{docker-compose.yml}

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.2
+ image: ghcr.io/plausible/community-edition:v2.1.3

and restart the containers

_console

$ cd hosting
$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.2:

Fixed

Change cookie key to resolve login issue #4621
Set secure attribute on cookies when BASE_URL has HTTPS scheme #4623
Don't track custom events in CE (fixes filters) #4627

Assets 2

3 Join discussion

25 Sep 12:09

ruslandoga

v2.1.2

00dffb5

v2.1.2

The highlights of this release are:

Automatic IPv6 support for all outgoing connections
Opt-in HTTPS support and Let's Encrypt integration
Simplified Docker Compose configuration
Various product improvements: https://plausible.io/changelog — up until today's date :)

Upgrade

Update the image used for plausible

_{docker-compose.yml}

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.1
+ image: ghcr.io/plausible/community-edition:v2.1.2

and restart the containers

_console

$ cd hosting
$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.1:

Added

UI to edit goals along with display names
Support contains filter for goals
UI to edit funnels
Add Details views for browsers, browser versions, os-s, os versions, and screen sizes reports
Add a search functionality in all Details views
Icons for browsers #4239
Automatic custom property selection in the dashboard Properties report
Add contains_not filter support to dashboard
Traffic drop notifications #4300
Add search and pagination functionality into Google Keywords > Details modal
ClickHouse system.query_log table log_comment column now contains information about source of queries. Useful for debugging
New /debug/clickhouse route for super admins which shows information on clickhouse queries executed by user
Typescript support for /assets
Testing framework for /assets
Automatic HTTPS #4491
Make details views on dashboard sortable

Removed

Deprecate ECTO_IPV6 and ECTO_CH_IPV6 env vars in CE #4245
Remove support for importing data from no longer available Universal Analytics
Soft-deprecate DATABASE_SOCKET_DIR #4202

Changed

Support Unix sockets in DATABASE_URL #4202
Realtime and hourly graphs now show visits lasting their whole duration instead when specific events occur
Increase hourly request limit for API keys in CE from 600 to 1000000 (practically removing the limit) #4200
Make TCP connections try IPv6 first with IPv4 fallback in CE #4245
is and is not filters in dashboard no longer support wildcards. Use contains/does not contain filter instead.
bounce_rate metric now returns 0 instead of null for event:page breakdown when page has never been entry page.
Make TOTP_VAULT_KEY optional #4317
Sources like 'google' and 'facebook' are now stored in capitalized forms ('Google', 'Facebook') #4417
DATABASE_CACERTFILE now forces TLS for PostgreSQL connections, so you don't need to add ?ssl=true in DATABASE_URL
Change auth session cookies to token-based ones with server-side expiration management.
Improve Google error messages in CE #4485
Better compress static assets in CE #4476
Return domain-less cookies in CE #4482
Internal stats API routes now return a JSON error over HTML in case of invalid access.

Fixed

Fix access to Stats API feature in CE #4244
Fix filter suggestions when same filter previously applied
Fix MX lookup when using relays with Bamboo.Mua #4350
Don't include imports when showing time series hourly interval. Previously imported data was shown each midnight
Fix property filter suggestions 500 error when property hasn't been selected
Bamboo.Mua: add Date and Message-ID headers if missing #4474
Fix migration order across plausible_db and plausible_events_db databases #4466

Assets 2

17 Join discussion

06 Jun 10:00

ruslandoga

v2.1.1

b096057

v2.1.1

This is a patch release with fixes to some of the problems reported in v2.1.0

Upgrading to v2.1.1

Important

This guide assumes you are already using v2.1.0

Update images

Update the image used for plausible

_{docker-compose.yml}

plausible:
- image: ghcr.io/plausible/community-edition:v2.1.0
+ image: ghcr.io/plausible/community-edition:v2.1.1

and restart the container

_console

$ cd hosting
$ docker compose stop plausible
$ docker compose rm plausible
$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.1.0:

Added

Snippet integration verification
Limited filtering support for imported data in the dashboard and via Stats API
Automatic sites.imported_data -> site_imports data migration in CE #4155

Fixed

Fix CSV import by adding a newline to the INSERT statement #4172
Fix url parameters escaping of = sign #4185
Fix redirect after registration in CE #4165
Fix VersionedSessions migration in ClickHouse v24 #4162

Assets 2

1 Join discussion

23 May 10:31

ruslandoga

v2.1.0

5881f1c

v2.1.0

The highlights of this release are:

🎉 Introduction of Community Edition [see below]
⬇️ GA4 import
🔁 CSV data export and import between self-hosted and cloud
🔐 TOTP for 2FA [docs]
✉️ New SMTP client [see below]
🔌 The new WordPress integration now works better thanks to the Plugin API
📚 Hosting documentation (now at plausible/community-edition) got an update and now includes a more thorough Google integration guide
📈 Sites page got a new look with spark charts

Introduction of Community Edition

As of version 2.1.0 this project will split into Plausible Community Edition and Plausible Enterprise Edition. The Community Edition (CE) will remain completely open source under the AGPLv3 license. The Enterprise Edition (EE) will contain extra features that will be published as source-available on Github, but we do not grant rights for anyone else to use, distribute or otherwise exploit these features. Read more here.

As part of this change, we are also rebranding the project. The new logos for CE and EE will be different so as to clarify which version is being referred to or used at any given time.

And finally as a contributor, you will have to sign a Contributor License Agreement (CLA) in order for your PRs to be considered for merging.

Upgrading to v2.1.0

Important

This guide assumes you are using v2.0.0 and have already run the data migration.

Update config

Add a secret key for the new required TOTP_VAULT_KEY environment variable

_console

$ openssl rand -base64 32
aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

_{plausible-conf.env}

  BASE_URL=https://plausible.example.com
  SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
+ TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

This new key is used to encrypt TOTP secrets at rest.

Update images

Update the images used for plausible and plausible_events_db and remove /entrypoint.sh db init-admin from your plausible.command

_{docker-compose.yml}

plausible:
- image: plausible/analytics:v2.0.0
- command: sh -c "sleep 10 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh db init-admin && /entrypoint.sh run"
+ image: ghcr.io/plausible/community-edition:v2.1.0
+ command: sh -c "sleep 10 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run"

plausible_events_db:
- image: clickhouse/clickhouse-server:22.6-alpine
+ image: clickhouse/clickhouse-server:24.3.3.102-alpine

and restart the containers

_console

$ cd hosting
$ docker compose stop plausible plausible_events_db
$ docker compose rm plausible plausible_events_db
$ docker compose up -d

This will boot up the new version of the app.

New SMTP client

If you were having problems with email delivery in the previous versions you can try switching to the new SMTP client by setting MAILER_ADAPTER to Bamboo.Mua. All the SMTP_* environment variables can stay the same.

_{plausible-conf.env}

  BASE_URL=https://plausible.example.com
  SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
  TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=
  SMTP_HOST_ADDR=smtp.gmail.com
  SMTP_HOST_PORT=587
  [email protected]
  SMTP_USER_PWD="wnqj fkbn jcwc byxk"
+ MAILER_ADAPTER=Bamboo.Mua

In addition, here's a short guide on using your Gmail account for email delivery.

Changelog

Following changes have been made since v2.0.0:

Added

Hostname Allow List in Site Settings
Pages Block List in Site Settings
Add conversion_rate to Stats API Timeseries and on the main graph
Add total_conversions and conversion_rate to visitors.csv in a goal-filtered CSV export
Ability to display total conversions (with a goal filter) on the main graph
Add conversion_rate to Stats API Timeseries and on the main graph
Add time_on_page metric into the Stats API
County Block List in Site Settings
Query the views_per_visit metric based on imported data as well if possible
Group operating_system_versions by operating_system in Stats API breakdown
Add operating_system_versions.csv into the CSV export
Display Total visitors, Conversions, and CR in the "Details" views of Countries, Regions and Cities (when filtering by a goal)
Add conversion_rate to Regions and Cities reports (when filtering by a goal)
Add the conversion_rate metric to Stats API Breakdown and Aggregate endpoints
IP Block List in Site Settings
Allow filtering with contains/matches operator for Sources, Browsers and Operating Systems.
Allow filtering by multiple custom properties
Wildcard and member filtering on the Stats API event:goal property
Allow filtering with contains/matches operator for custom properties
Add referrers.csv to CSV export
Add a new Properties section in the dashboard to break down by custom properties
Add custom_props.csv to CSV export (almost the same as the old prop_breakdown.csv, but has different column headers, and includes props for pageviews too, not only custom events)
Add referrers.csv to CSV export
Improve password validation in registration and password reset forms
Adds Gravatar profile image to navbar
Enforce email reverification on update
Add Plugins API Tokens provisioning UI
Add searching sites by domain in /sites view
Add last 24h plots to /sites view
Add site pinning to /sites view
Add support for JSON logger, via LOG_FORMAT=json environment variable
Add support for 2FA authentication
Add 'browser_versions.csv' to CSV export
Add CLICKHOUSE_MAX_BUFFER_SIZE_BYTES env var which defaults to 100000 (100KB)
Add alternative SMTP adapter #3654
Add EXTRA_CONFIG_PATH env var to specify extra Elixir config #3906
Add restrictive robots.txt for self-hosted #3905
Add Yesterday as an time range option in the dashboard
Add dmg extension to the list of default tracked file downloads
Add support for importing Google Analytics 4 data
Import custom events from Google Analytics 4
Ability to filter Search Console keywords by page, country and device #4077
Add DATA_DIR env var for exports/imports #4100
Add custom events support to CSV export and import

Removed

Removed the nested custom event property breakdown UI when filtering by a goal in Goal Conversions
Removed the prop_names returned in the Stats API event:goal breakdown response
Removed the prop-breakdown.csv file from CSV export
Deprecated CLICKHOUSE_MAX_BUFFER_SIZE
Removed /app/init-admin.sh that was deprecated in v2.0.0 #3903
Remove DISABLE_AUTH deprecation warning #3904

Changed

A visits entry_page and exit_page is only set and updated for pageviews, not custom events
Limit the number of Goal Conversions shown on the dashboard and render a "Details" link when there are more entries to show
Show Outbound Links / File Downloads / 404 Pages / Cloaked Links instead of Goal Conversions when filtering by the corresponding goal
Require custom properties to be explicitly added from Site Settings > Custom Properties in order for them to show up on the dashboard
GA/SC sections moved to new settings: Integrations
Replace CLICKHOUSE_MAX_BUFFER_SIZE with CLICKHOUSE_MAX_BUFFER_SIZE_BYTES
Validate metric isn't queried multiple times
Filters in dashboard are represented by jsonurl

Fixed

Creating many sites no longer leads to cookie overflow
Ignore sessions without pageviews for entry_page and exit_page breakdowns
Using VersionedCollapsingMergeTree to store visit data to avoid rare race conditions that led to wrong visit data being shown
Fix conversion_rate metric in a browser_versions breakdown
Calculate conversion_rate percentage change in the same way like bounce_rate (subtraction instead of division)
Calculate bounce_rate percentage change in the Stats API in the same way as it's done in the dashboard
Stop returning custom events in goal breakdown with a pageview goal filter and vice versa
Only return (none) values in custom property breakdown for the first page (pagination) of results
Fixed weekly/monthly e-mail report rendering issues
Fix broken interval selection in the all time view #3110
Fixed IPv6 problems in data migration #3179
Fixed long URLs display in Outbound Link breakdown view
Fixed Sentry reports for ingestion requests #3182
Fi...

Assets 2

63 Join discussion

08 May 08:47

ruslandoga

v2.1.0-rc.1

d8435f2

v2.1.0-rc.1 Pre-release

Pre-release

Warning

The previous v2.1.0-rc.1 image had incorrect settings that disabled GA4 imports and CSV exports/imports.
Please re-pull the image if you don't see "Imports & Exports" section in site settings.

The highlights of this release candidate are:

🎉 Introduction of Community Edition [see below]
⬇️ GA4 import
🔁 CSV data export and import between self-hosted and cloud
🔐 TOTP for 2FA [docs]
✉️ New SMTP client [see below]
🔌 The new WordPress integration now works better thanks to the Plugin API
📚 Hosting documentation (now at plausible/community-edition) got an update and now includes a more thorough Google integration guide
📈 Sites page got a new look with spark charts

Introduction of Community Edition

As part of this change, we are also rebranding the project. The new logos for CE and EE will be different so as to clarify which version is being referred to or used at any given time.

And finally as a contributor, you will have to sign a Contributor License Agreement (CLA) in order for your PRs to be considered for merging.

Upgrading to v2.1.0-rc.1

Important

This guide assumes you are using v2.0.0

Update config

Add a secret key for the new required TOTP_VAULT_KEY environment variable

_console

$ openssl rand -base64 32
aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

_{plausible-conf.env}

  BASE_URL=https://plausible.example.com
  SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
+ TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

This new key is used to encrypt TOTP secrets at rest.

Update images

Update the images used for plausible and plausible_events_db

_{docker-compose.yml}

plausible:
- image: plausible/analytics:v2.0.0
+ image: ghcr.io/plausible/community-edition:v2.1.0-rc.1

plausible_events_db:
- image: clickhouse/clickhouse-server:22.6-alpine
+ image: clickhouse/clickhouse-server:23.3.7.5-alpine

and restart the containers

_console

$ cd hosting
$ docker compose stop plausible plausible_events_db
$ docker compose rm plausible plausible_events_db
$ docker compose up -d

This will boot up the new version of the app.

New SMTP client

If you were having problems with email delivery in v2.1.0-rc.0, you can switch to the new SMTP client by setting MAILER_ADAPTER to Bamboo.Mua. All the SMTP_* environment variables can stay the same.

_{plausible-conf.env}

  BASE_URL=https://plausible.example.com
  SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
  TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=
  SMTP_HOST_ADDR=smtp.gmail.com
  SMTP_HOST_PORT=587
  [email protected]
  SMTP_USER_PWD="wnqj fkbn jcwc byxk"
+ MAILER_ADAPTER=Bamboo.Mua

In addition, here's a short guide on using your Gmail account for email delivery.

Changelog

Following changes have been made since v2.0.0:

Added

Hostname Allow List in Site Settings
Pages Block List in Site Settings
Add conversion_rate to Stats API Timeseries and on the main graph
Add total_conversions and conversion_rate to visitors.csv in a goal-filtered CSV export
Ability to display total conversions (with a goal filter) on the main graph
Add conversion_rate to Stats API Timeseries and on the main graph
Add time_on_page metric into the Stats API
County Block List in Site Settings
Query the views_per_visit metric based on imported data as well if possible
Group operating_system_versions by operating_system in Stats API breakdown
Add operating_system_versions.csv into the CSV export
Display Total visitors, Conversions, and CR in the "Details" views of Countries, Regions and Cities (when filtering by a goal)
Add conversion_rate to Regions and Cities reports (when filtering by a goal)
Add the conversion_rate metric to Stats API Breakdown and Aggregate endpoints
IP Block List in Site Settings
Allow filtering with contains/matches operator for Sources, Browsers and Operating Systems.
Allow filtering by multiple custom properties
Wildcard and member filtering on the Stats API event:goal property
Allow filtering with contains/matches operator for custom properties
Add referrers.csv to CSV export
Add a new Properties section in the dashboard to break down by custom properties
Add custom_props.csv to CSV export (almost the same as the old prop_breakdown.csv, but has different column headers, and includes props for pageviews too, not only custom events)
Add referrers.csv to CSV export
Improve password validation in registration and password reset forms
Adds Gravatar profile image to navbar
Enforce email reverification on update
Add Plugins API Tokens provisioning UI
Add searching sites by domain in /sites view
Add last 24h plots to /sites view
Add site pinning to /sites view
Add support for JSON logger, via LOG_FORMAT=json environment variable
Add support for 2FA authentication
Add 'browser_versions.csv' to CSV export
Add CLICKHOUSE_MAX_BUFFER_SIZE_BYTES env var which defaults to 100000 (100KB)
Add alternative SMTP adapter #3654
Add EXTRA_CONFIG_PATH env var to specify extra Elixir config #3906
Add restrictive robots.txt for self-hosted #3905
Add Yesterday as an time range option in the dashboard

Removed

Removed the nested custom event property breakdown UI when filtering by a goal in Goal Conversions
Removed the prop_names returned in the Stats API event:goal breakdown response
Removed the prop-breakdown.csv file from CSV export
Deprecated CLICKHOUSE_MAX_BUFFER_SIZE
Removed /app/init-admin.sh that was deprecated in v2.0.0 #3903
Remove DISABLE_AUTH deprecation warning #3904

Changed

A visits entry_page and exit_page is only set and updated for pageviews, not custom events
Limit the number of Goal Conversions shown on the dashboard and render a "Details" link when there are more entries to show
Show Outbound Links / File Downloads / 404 Pages / Cloaked Links instead of Goal Conversions when filtering by the corresponding goal
Require custom properties to be explicitly added from Site Settings > Custom Properties in order for them to show up on the dashboard
GA/SC sections moved to new settings: Integrations
Replace CLICKHOUSE_MAX_BUFFER_SIZE with CLICKHOUSE_MAX_BUFFER_SIZE_BYTES
Validate metric isn't queried multiple times

Fixed

Creating many sites no longer leads to cookie overflow
Ignore sessions without pageviews for entry_page and exit_page breakdowns
Using VersionedCollapsingMergeTree to store visit data to avoid rare race conditions that led to wrong visit data being shown
Fix conversion_rate metric in a browser_versions breakdown
Calculate conversion_rate percentage change in the same way like bounce_rate (subtraction instead of division)
Calculate bounce_rate percentage change in the Stats API in the same way as it's done in the dashboard
Stop returning custom events in goal breakdown with a pageview goal filter and vice versa
Only return (none) values in custom property breakdown for the first page (pagination) of results
Fixed weekly/monthly e-mail report rendering issues
Fix broken interval selection in the all time view #3110
Fixed IPv6 problems in data migration #3179
Fixed long URLs display in Outbound Link breakdown view
Fixed Sentry reports for ingestion requests #3182
Fix breakdown pagination bug in the dashboard details view when filtering by goals
Update bot detection (matomo 6.1.4, ua_inspector 3.4.0)
Improved the Goal Settings page (search, autcompletion etc.)
Log mailer errors #3336
Allow custom event timeseries in stats API #3505
Fixes for sites with UTF characters in domain #3560
Fix crash when using special characters in filter #3634
Fix automatic scrolling to the bottom on the dashboard if previously selected properties tab #3872
Allow running ...

Assets 2

114 Join discussion

23 Feb 13:25

ruslandoga

v2.1.0-rc.0

a1fedb7

v2.1.0-rc.0 Pre-release

Pre-release

The highlights of this release candidate are:

Introduction of Community Edition [see below]
TOTP for 2FA [docs]
Sites page got a new look with spark charts
The new WordPress integration now works better thanks to the Plugin API
Hosting documentation (now at plausible/community-edition) also got an update and now includes a more thorough Google integration guide
Even though not present in this release candidate, importing the data between self-hosted and cloud will be available in v2.1.0

Introduction of Community Edition

As part of this change, we are also rebranding the project. The new logos for CE and EE will be different so as to clarify which version is being referred to or used at any given time.

And finally as a contributor, you will have to sign a Contributor License Agreement (CLA) in order for you PRs to be considered for merging.

Upgrading to v2.1.0-rc.0

⚠️ This guide assumes you are using v2.0.0 ⚠️

Update config

Add a secret key for the new required TOTP_VAULT_KEY environment variable

_console

$ openssl rand -base64 32
aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

_{plausible-conf.env}

  BASE_URL=https://plausible.example.com
  SECRET_KEY_BASE=PkVcxRgQDfQyhPETlog3vvCrj5LdYFSv4ejPEJHJO+i/37w6RZfRjeVCpJayjUjJMfXsNurcv5upPhTRoD3KgQ==
+ TOTP_VAULT_KEY=aihU7k+GSBKbcVFuX9VEPyUhuwlKEomqA94/SQQ0NR4=

This new key is used to encrypt TOTP secrets at rest.

Update images

Update the images used for plausible and plausible_events_db (thank you @lordcris #3817 (comment))

_{docker-compose.yml}

plausible:
- image: plausible/analytics:v2.0.0
+ image: ghcr.io/plausible/community-edition:v2.1.0-rc.0

plausible_events_db:
- image: clickhouse/clickhouse-server:22.6-alpine
+ image: clickhouse/clickhouse-server:23.3.7.5-alpine

and restart the containers

_console

$ cd hosting
$ docker compose stop plausible plausible_events_db
$ docker compose rm plausible plausible_events_db
$ docker compose up -d

This will boot up the new version of the app.

Changelog

Following changes have been made since v2.0.0:

Added

IP Block List in Site Settings
Allow filtering with contains/matches operator for Sources, Browsers and Operating Systems.
Allow filtering by multiple custom properties
Wildcard and member filtering on the Stats API event:goal property
Allow filtering with contains/matches operator for custom properties
Add referrers.csv to CSV export
Add a new Properties section in the dashboard to break down by custom properties
Add custom_props.csv to CSV export (almost the same as the old prop_breakdown.csv, but has different column headers, and includes props for pageviews too, not only custom events)
Add referrers.csv to CSV export
Improve password validation in registration and password reset forms
Adds Gravatar profile image to navbar
Enforce email reverification on update
Add Plugins API Tokens provisioning UI
Add searching sites by domain in /sites view
Add last 24h plots to /sites view
Add site pinning to /sites view
Add support for JSON logger, via LOG_FORMAT=json environment variable
Add support for 2FA authentication
Add 'browser_versions.csv' to CSV export
Add CLICKHOUSE_MAX_BUFFER_SIZE_BYTES env var which defaults to 100000 (100KB)

Removed

Removed the nested custom event property breakdown UI when filtering by a goal in Goal Conversions
Removed the prop_names returned in the Stats API event:goal breakdown response
Removed the prop-breakdown.csv file from CSV export
Deprecated CLICKHOUSE_MAX_BUFFER_SIZE

Changed

Limit the number of Goal Conversions shown on the dashboard and render a "Details" link when there are more entries to show
Show Outbound Links / File Downloads / 404 Pages / Cloaked Links instead of Goal Conversions when filtering by the corresponding goal
Require custom properties to be explicitly added from Site Settings > Custom Properties in order for them to show up on the dashboard
GA/SC sections moved to new settings: Integrations
Replace CLICKHOUSE_MAX_BUFFER_SIZE with CLICKHOUSE_MAX_BUFFER_SIZE_BYTES

Fixed

Stop returning custom events in goal breakdown with a pageview goal filter and vice versa
Only return (none) values in custom property breakdown for the first page (pagination) of results
Fixed weekly/monthly e-mail report rendering issues
Fix broken interval selection in the all time view #3110
Fixed IPv6 problems in data migration #3179
Fixed long URLs display in Outbound Link breakdown view
Fixed Sentry reports for ingestion requests #3182
Fix breakdown pagination bug in the dashboard details view when filtering by goals
Update bot detection (matomo 6.1.4, ua_inspector 3.4.0)
Improved the Goal Settings page (search, autcompletion etc.)
Log mailer errors #3336
Allow custom event timeseries in stats API #3505
Fixes for sites with UTF characters in domain #3560
Fix crash when using special characters in filter #3634

Contributors

lordcris

Assets 2

85 Join discussion

Releases: plausible/analytics

v2.1.5

Upgrade

Changelog

Added

Removed

v2.1.5-rc.4

Upgrade

Changelog

Added

Removed

v2.1.5-rc.1

Upgrade

Changelog

Added

Removed

v2.1.4

Upgrade

Changelog

Added

Changed

Fixed

v2.1.3

Upgrade

Changelog

Fixed

v2.1.2

Upgrade

Changelog

Added

Removed

Changed

Fixed

v2.1.1

Upgrading to v2.1.1

Update images

Changelog

Added

Fixed

v2.1.0

Introduction of Community Edition

Upgrading to v2.1.0

Update config

Update images

New SMTP client

Changelog

Added

Removed

Changed

Fixed

v2.1.0-rc.1

Introduction of Community Edition

Upgrading to v2.1.0-rc.1

Update config

Update images

New SMTP client

Changelog

Added

Removed

Changed

Fixed

v2.1.0-rc.0

Introduction of Community Edition

Upgrading to v2.1.0-rc.0

Update config

Update images

Changelog

Added

Removed

Changed

Fixed

Contributors