upgrading.md

How To Upgrade bbb-docker

Breaking changes v2.7.x -> v3.0.x

• A setup behind NAT does currently not work!
• 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
  • make sure you have docker ≥ 23.0 installed ($ docker -v)
  • update all usages of docker-compose to docker compose in your scripts

Breaking changes v2.5.x -> v2.6.x

• Greenlight got fully rewritten
  • it is starting as a fresh installation. you can migrate your data with ./scripts/greenlight-migrate-v2-v3
  • some greenlight settings under .env have changed. compare your version with sample.env
  • it is now served directly under / and not in /b. If you use an reverse proxy not included in this repo, ensure to update your config accordingly!

Backup

if you use greenlight, create a database backup first

docker exec -t docker_postgres_1 pg_dumpall -c -U postgres > /root/greenlight_`date +%d-%m-%Y"_"%H_%M_%S`.sql

Upgrading

# upgrade!
./scripts/upgrade

# restart updated services
docker compose up -d --no-build