diff --git a/README.md b/README.md
index 1f85b7e..fde8e32 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@ Version: 3.0.1 | [Changelog](CHANGELOG.md) | [Issues](https://github.com/bigblue
 - Root access (bbb-docker uses host networking, so it won't work with Kubernetes, any "CaaS"-Service, etc.)
 - Public IPv4 (expect issues with a firewall / NAT)
 - firewall allows internal networking (e.g. for ufw: `ufw allow 10.7.7.0/24`)
+- git installed
 
 ## Install production server
 1. Ensure the requirements above are fulfilled (it really doesn't work without them)
@@ -40,7 +41,7 @@ Version: 3.0.1 | [Changelog](CHANGELOG.md) | [Issues](https://github.com/bigblue
    $ git clone https://github.com/bigbluebutton/docker.git bbb-docker
    $ cd bbb-docker
 
-   # use the more stable main branch (sometimes older)
+   # optional: use the more stable main branch (often much older)
    $ git checkout main 
    ```
 4. Run setup:
diff --git a/docs/upgrading.md b/docs/upgrading.md
index 50f0b43..b2e8f7a 100644
--- a/docs/upgrading.md
+++ b/docs/upgrading.md
@@ -2,7 +2,9 @@
 
 ### Breaking changes `v2.7.x` -> `v3.0.x`
 - **A setup behind NAT does currently not work!**
-- on every SIP Profiles the extension field needs to be set to "DIALIN" 
+- `LETSENCRYPT_EMAIL` is now required in `.env` when used with the integrated HAProxy
+- the greenlight postgres database is now called `greenlight` instead of `greenlight-v3`
+
 
 ### Breaking changes `v2.6.x` -> `v2.7.x`
 - We use now Docker Compose V2