diff --git a/content/api-reference/auth/sendVerificationEmail.mdx b/content/api-reference/auth/sendVerificationEmail.mdx index 018dfcb1..dd9fe949 100644 --- a/content/api-reference/auth/sendVerificationEmail.mdx +++ b/content/api-reference/auth/sendVerificationEmail.mdx @@ -12,14 +12,14 @@ _openapi: Send a verification email to the user email address. The email is only sent if have configured [SMTP mail - server](https://docs.logchimp.codecarrot.net/docs/environment-variables#mail) + server](https://docs.logchimp.codecarrot.net/self-hosting/environment-variables#mail) are configured at the time of deploying LogChimp. --- {/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */} Send a verification email to the user email address. -The email is only sent if have configured [SMTP mail server](https://docs.logchimp.codecarrot.net/docs/environment-variables#mail) are configured at the time of deploying LogChimp. +The email is only sent if have configured [SMTP mail server](https://docs.logchimp.codecarrot.net/self-hosting/environment-variables#mail) are configured at the time of deploying LogChimp. \ No newline at end of file diff --git a/content/docs/meta.json b/content/docs/meta.json new file mode 100644 index 00000000..dbf96f6a --- /dev/null +++ b/content/docs/meta.json @@ -0,0 +1,19 @@ +{ + "root": true, + "pages": [ + "---Introduction---", + "what-is-logchimp", + "---Getting Started---", + "install", + "environment-variables", + "---Resources---", + "resources/ecosystem", + "resources/architecture", + "resources/support", + "---Miscellaneous---", + "[HandHelping][Contributing](https://github.com/logchimp/logchimp/blob/master/CONTRIBUTING.md)", + "miscellaneous/faq", + "miscellaneous/security-policy" + ], + "defaultOpen": true +} \ No newline at end of file diff --git a/content/platform/additional-resources/breaking-changes-pg18.mdx b/content/platform/additional-resources/breaking-changes-pg18.mdx new file mode 100644 index 00000000..7d288c69 --- /dev/null +++ b/content/platform/additional-resources/breaking-changes-pg18.mdx @@ -0,0 +1,25 @@ +## Breaking Changes: PostgreSQL 12 → 18 + + + ⚠️ **Important Notice:** + Upgrading to PostgreSQL 18 introduces a new cluster storage layout that is **not compatible** with PostgreSQL 12. + Existing Docker volumes or data directories from v12 **will fail to start** unless properly migrated. + Please back up your data and follow the steps below before proceeding with any upgrade. + + +## Summary +PostgreSQL 18 introduces a new cluster storage layout incompatible with version 12. + +## Impact +- Existing Docker volumes from v12 will fail to mount directly. +- `pg_upgrade` or data export/import is required. +- Environment variables and data paths differ (`/var/lib/postgresql/18/data`). + +## Recommended Action +1. Backup all data from v12. +2. Use the official upgrade container or `pg_upgrade`. +3. Verify compatibility in staging before production rollout. + +## References +- [PostgreSQL Docker Migration Notes](https://github.com/docker-library/postgres/pull/1259) +- [Official PostgreSQL Upgrade Guide](https://www.postgresql.org/docs/18/pgupgrade.html) diff --git a/content/self-hosting/deployments/railway.mdx b/content/self-hosting/deployments/railway.mdx index 4983048a..b351d36c 100644 --- a/content/self-hosting/deployments/railway.mdx +++ b/content/self-hosting/deployments/railway.mdx @@ -13,9 +13,20 @@ There are many ways to [install LogChimp](/self-hosting/installation). With Rail notifications and more. +<<<<<<< HEAD:content/self-hosting/deployments/railway.mdx Deploy on Railway +======= + + ⚠️ **Breaking Change (PostgreSQL 12 → 18)** + LogChimp now uses PostgreSQL 18 which introduces an incompatible data directory structure. + Existing Docker volumes or databases from PostgreSQL 12 **will not work directly** with this version. + Please review the [Breaking Change – PostgreSQL 12 → 18](/docs/miscellaneous/breaking-changes-pg18) page before upgrading or deploying. + + +[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/new/template/3Bm-Un?referralCode=mittalyashu) +>>>>>>> a15bdd0 (docs: add PostgreSQL 12→18 breaking change notice and link from Docker page):content/docs/install/railway.mdx All the environment variables are pre-configured for you. You can learn more about them [here](/self-hosting/environment-variables). diff --git a/content/self-hosting/deployments/render.mdx b/content/self-hosting/deployments/render.mdx index 179c9dce..7501517f 100644 --- a/content/self-hosting/deployments/render.mdx +++ b/content/self-hosting/deployments/render.mdx @@ -13,7 +13,18 @@ Clicking the "Deploy to Render" button will redirect you to the Render blueprint notifications and more. +<<<<<<< HEAD:content/self-hosting/deployments/render.mdx All the environment variables are pre-configured for you. You can learn more about them [here](/self-hosting/environment-variables). +======= + + ⚠️ **Breaking Change (PostgreSQL 12 → 18)** + LogChimp now uses PostgreSQL 18 which introduces an incompatible data directory structure. + Existing Docker volumes or databases from PostgreSQL 12 **will not work directly** with this version. + Please review the [Breaking Change – PostgreSQL 12 → 18](/docs/miscellaneous/breaking-changes-pg18) page before upgrading or deploying. + + +All the environment variables are pre-configured for you. You can learn more about them [here](/docs/environment-variables). +>>>>>>> a15bdd0 (docs: add PostgreSQL 12→18 breaking change notice and link from Docker page):content/docs/install/render.mdx Deploy to Render diff --git a/content/self-hosting/docker.mdx b/content/self-hosting/docker.mdx index a9a271ac..7eb787d2 100644 --- a/content/self-hosting/docker.mdx +++ b/content/self-hosting/docker.mdx @@ -98,3 +98,19 @@ Phew! That was a lot of work! Let's move to next step. Connect your application with LogChimp. +<<<<<<< HEAD:content/self-hosting/docker.mdx +======= + +## Resources + +- LogChimp Docker images: +- APIs - [link](https://github.com/orgs/logchimp/packages/container/package/logchimp%2Fapi) +- Theme - [link](https://github.com/orgs/logchimp/packages/container/package/logchimp%2Ftheme) + + + ⚠️ **Breaking Change (PostgreSQL 12 → 18)** + LogChimp now uses PostgreSQL 18 which introduces an incompatible data directory structure. + Existing Docker volumes or databases from PostgreSQL 12 **will not work directly** with this version. + Please review the [Breaking Change – PostgreSQL 12 → 18](/docs/miscellaneous/breaking-changes-pg18) page before upgrading or deploying. + +>>>>>>> a15bdd0 (docs: add PostgreSQL 12→18 breaking change notice and link from Docker page):content/docs/install/docker.mdx diff --git a/content/self-hosting/meta.json b/content/self-hosting/meta.json index fe232892..2d088089 100644 --- a/content/self-hosting/meta.json +++ b/content/self-hosting/meta.json @@ -1,15 +1,18 @@ { - "root": true, - "pages": [ - "---Getting Started---", - "installation", - "environment-variables", - "docker", - "---Deployments---", - "deployments/railway", - "deployments/render", - "---Additional Resources---", - "support" - ], - "defaultOpen": true + "root": true, + "pages": [ + "---Getting Started---", + "installation", + "environment-variables", + "docker", + "---Deployments---", + "deployments/railway", + "deployments/render", + "---Additional Resources---", + "support", + "---Miscellaneous---", + "[HandHelping][Contributing](https://github.com/logchimp/logchimp/blob/master/CONTRIBUTING.md)", + "miscellaneous/breaking-changes-pg18" + ], + "defaultOpen": true }