From 78124a5076c50d4fc4be374494cf59d85fc5dd38 Mon Sep 17 00:00:00 2001
From: trav <trav@teafry.me>
Date: Wed, 24 Jun 2026 17:27:12 +0100
Subject: [PATCH 1/2] chore: upgrade to
 ghcr.io/plausible/community-edition:v3.2.1

- Switch app image from plausible/analytics:v2.0.0 to
  ghcr.io/plausible/community-edition:v3.2.1 (image registry changed at v3.x)
- Bump ClickHouse from 23.4.2.11-alpine to 24.12-alpine (required for CE v3.x)
- Add CLICKHOUSE_SKIP_USER_SETUP=1 env var to ClickHouse service (required for v3.0.0+)
- Add ClickHouse healthcheck
- Update clickhouse-user-config.xml: replace deprecated <yandex> root with
  <clickhouse> root; adopt CE low-resource profile settings for < 16 GB RAM hosts
---
 clickhouse-user-config.xml | 17 +++++++++++++----
 compose.yml                | 11 +++++++++--
 2 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/clickhouse-user-config.xml b/clickhouse-user-config.xml
index f795286..42d5e40 100644
--- a/clickhouse-user-config.xml
+++ b/clickhouse-user-config.xml
@@ -1,8 +1,17 @@
-<yandex>
+<!-- https://clickhouse.com/docs/en/operations/tips#using-less-than-16gb-of-ram -->
+<clickhouse>
     <profiles>
         <default>
-            <log_queries>0</log_queries>
-            <log_query_threads>0</log_query_threads>
+            <!-- https://clickhouse.com/docs/en/operations/settings/settings#max_threads -->
+            <max_threads>1</max_threads>
+            <!-- https://clickhouse.com/docs/en/operations/settings/settings#max_block_size -->
+            <max_block_size>8192</max_block_size>
+            <!-- https://clickhouse.com/docs/en/operations/settings/settings#max_download_threads -->
+            <max_download_threads>1</max_download_threads>
+            <!-- https://clickhouse.com/docs/en/operations/settings/settings#input_format_parallel_parsing -->
+            <input_format_parallel_parsing>0</input_format_parallel_parsing>
+            <!-- https://clickhouse.com/docs/en/operations/settings/settings#output_format_parallel_formatting -->
+            <output_format_parallel_formatting>0</output_format_parallel_formatting>
         </default>
     </profiles>
-</yandex>
+</clickhouse>
diff --git a/compose.yml b/compose.yml
index ca1e152..dda5349 100644
--- a/compose.yml
+++ b/compose.yml
@@ -3,7 +3,7 @@ version: "3.8"
 
 services:
   app:
-    image: plausible/analytics:v2.0.0
+    image: ghcr.io/plausible/community-edition:v3.2.1
     command: sh -c "sleep 10 && /entrypoint.sh db createdb && /entrypoint.sh db migrate && /entrypoint.sh run"
     depends_on:
       - db
@@ -67,10 +67,17 @@ services:
         backupbot.restore.post-hook: "/pg_backup.sh restore"
 
   plausible_events_db:
-    image: clickhouse/clickhouse-server:23.4.2.11-alpine
+    image: clickhouse/clickhouse-server:24.12-alpine
     volumes:
       - event-data:/var/lib/clickhouse
     entrypoint: /custom-entrypoint.sh
+    environment:
+      - CLICKHOUSE_SKIP_USER_SETUP=1
+    healthcheck:
+      test: ["CMD-SHELL", "clickhouse-client --query='SELECT 1'"]
+      interval: 5s
+      timeout: 5s
+      retries: 60
     configs:
       - source: clickhouse-config
         target: /etc/clickhouse-server/config.d/logging.xml
-- 
2.49.0


From ad6b93a1f4f306a75e4ad9e1bfe0f09879023a2e Mon Sep 17 00:00:00 2001
From: trav <trav@teafry.me>
Date: Wed, 24 Jun 2026 17:37:04 +0100
Subject: [PATCH 2/2] fix: update .env.sample for CE v3.x SMTP requirements and
 add config versions

---
 .env.sample | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/.env.sample b/.env.sample
index c7fc131..47522d8 100644
--- a/.env.sample
+++ b/.env.sample
@@ -7,5 +7,20 @@ DOMAIN=plausible.example.com
 LETS_ENCRYPT_ENV=production
 
 SECRET_KEY_BASE=replace-me
-DISABLE_AUTH=replace-me # true or false
-DISABLE_REGISTRATION=replace-me # true or false
+DISABLE_AUTH=false
+DISABLE_REGISTRATION=true
+
+## SMTP settings (required — SMTP_HOST_PORT must be an integer)
+SMTP_HOST_ADDR=localhost
+MAILER_EMAIL=noreply@plausible.example.com
+SMTP_HOST_PORT=25
+#SMTP_USER_NAME=
+#SMTP_USER_PWD=
+SMTP_HOST_SSL_ENABLED=false
+
+## Config object versions (increment when config file content changes)
+CLICKHOUSE_CONF_VERSION=v1
+CLICKHOUSE_USER_CONF_VERSION=v1
+CLICKHOUSE_ENTRYPOINT_VERSION=v1
+PG_BACKUP_VERSION=v1
+CLICKHOUSE_BACKUP_SCRIPT_VERSION=v1
-- 
2.49.0