From a338f3b58d638463a29cf662543953e4d40022ea Mon Sep 17 00:00:00 2001
From: chapeau <me@chapoline.me>
Date: Fri, 22 Mar 2024 23:12:22 +0100
Subject: [PATCH 1/2] Changelog for 3.0-rc

---
 CHANGELOG.md       | 23 +++++++++++++++++++++--
 docker-compose.yml |  2 ++
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d913af3d..939fc2ed 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,9 +2,28 @@
 
 ## Install steps
 
-Starting with this release, the legacy installation script is no longer supporter. You can now use the brand new docker-based installation.
+Starting with this release, the legacy installation script is no longer supported. You can now use the brand new docker-based installation at [Docker-installation](https://gitlab.federez.net/re2o/re2o/-/wikis/Docker-installation)
 
-TODO: describe docker installation when it will be prod-ready
+### Migration guide from Re2o 2.9
+
+- Run a git pull
+- Ensure that `docker` and `docker-compose` are installed on the server
+- Shut down re2o and **make a backup**
+- Edit `docker-compose.yml` to suit your needs (notably, you will need to remove the database section, and to provide information for database connection. You can ignore superuser informations)
+- If you use custom invoice or voucher template, you will need to mount them in the docker by adding
+```yaml
+    volumes:
+      - /path/to/invoice/template:templates/default_invoive.html:ro
+      - /path/to/voucher/template:templates/default_voucher.html:ro
+```
+- If you use external optional apps, you will need to mount them in the docker by adding
+```yaml
+    volumes:
+      - /path/to/external/app:app:ro
+```
+- run `docker compose up`
+
+You will also need to edit the listening port of the nginx docker to be compatible with your reverse proxy configuration.
 
 ## Breaking changes
 
diff --git a/docker-compose.yml b/docker-compose.yml
index 880d40c4..8abc943d 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -21,6 +21,8 @@ services:
       target: postgres
     depends_on:
       - db
+    volumes:
+      - ./re2o/settings_local.py:./re2o/settings_local.py:ro
     environment:
       - POSTGRES_DB=postgres
       - POSTGRES_USER=postgres

From 25a6ece2188177af4c5e6d27af52a14e9f31b7fa Mon Sep 17 00:00:00 2001
From: chapeau <me@chapoline.me>
Date: Fri, 22 Mar 2024 23:26:53 +0100
Subject: [PATCH 2/2] Add intro

---
 CHANGELOG.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 939fc2ed..93fc8b68 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,6 @@
-# Re2o 3.0
+# Re2o 3.0 - Long time no see!
+
+3 years after the last release, here is the long-waited 3.0 release of Re2o! It comes with a update to (EOL) Django 2.2, a new docker-based installation, a new Radius script, and a great rework on CI tests.
 
 ## Install steps