📝 Changelog

[juliusknorr]

This issue will keep getting updates about changes that are relevant for developers using this setup or the images.

You can subscribe to it to get updates.

Updating to the latest version

• git pull to get the latest changes
• make pull-installed to pull the latest versions of all images that are already downloaded
• make pull-all to pull the latest versions of all images
• After pulling make sure to either recreate the containers manually or recreate the full development environment through docker compose down -v and docker compose up -d proxy nextcloud ... for the containers in use

[juliusknorr]

Added

• 📦 The sysvsem PHP module is now included in the images as it was introduced as a recommendation in Limit number of concurrent preview generations server#18210
• 🐘 PHP 8.2.0 RC6 is available as a new image: nextcloud-dev-php82
  • The blackfire module is still missing as it is not available yet

Breaking changes

• 🧩 Xdebug and Blackfire are disabled by default now. A script has been added to seamlessly switch between the different modes. The first argument represents the container name from docker-compose.yml:
  • Enable xdebug for step debugging: ./scripts/php-mod-config nextcloud xdebug.mode debug
  • Enable xdebug for profiling: ./scripts/php-mod-config nextcloud xdebug.mode profile
  • Enable xdebug for tracing: ./scripts/php-mod-config nextcloud xdebug.mode trace
  • Disable xdebug: ./scripts/php-mod-config nextcloud xdebug.mode of
  • Enable blackfire ./scripts/php-mod-config nextcloud blackfire on
  • Disable blackfire ./scripts/php-mod-config nextcloud blackfire off

[juliusknorr]

• 🚚 The nextcloud-dev-php images are now also able to run in standalone mode.
  This allows to spin up small development setups without the need for using the full docker-compose setup.
  If no volume mounts are provided the server source code will be fetched from master or a provided git tag through SERVER_BRANCH
  • Run a container for app development with the server master branch:

    docker run --rm -p 8080:80 ghcr.io/juliushaertl/nextcloud-dev-php80:latest

  • Run a container for app development with the server stable version 24.0.1 branch:

    docker run --rm -p 8080:80 -e SERVER_BRANCH=v24.0.1 ghcr.io/juliushaertl/nextcloud-dev-php80:latest

  • Develop an app with a local source code:

    docker run --rm -p 8080:80 -v ~/path/to/app:/var/www/html/apps-extra/app ghcr.io/juliushaertl/nextcloud-dev-php80:latest

  • For easier debugging you can also mount a local path for the server code (either an empty one or the path to your already checked out server codebase):

    docker run --rm -p 8080:80 -v ~/path/to/server:/var/www/html ghcr.io/juliushaertl/nextcloud-dev-php80:latest

• 📦 The following tools have been added to the php images to ease development for users that don't have those installed locally:
  • composer in the latest release available during image build
  • PHPUnit is available in two versions: phpunit8 and phpunit9
  • nvm for managing Node.js versions with the following preinstalled ones:
    • Node.js 14 and npm 7
    • Node.js 16 and npm 8

[juliusknorr]

• 🔧 Fresh development environment setups will automatically install and enable the hmr_enabler app to ease frontend development with hot module reloading. (thanks to @christianlupus for the contribution)
  • Existing installations can make use of this by cloning the app manually to their workspace app directory and make sure the app id is listed in the .env file in the list of NEXTCLOUD_AUTOINSTALL_APPS

[juliusknorr]

• 📦 The gmp extension has been added to the php images (thanks to @st3iny for the contribution)

[juliusknorr]

• 📦 The ADDITIONAL_APPS_PATH is now providing a shared mount to all Nextcloud containers. It can be used to have one git checkout of apps that support multiple Nextcloud releases. The default location is data/apps-extra.
  • ⚠️ For existing installations: Make sure that ADDITIONAL_APPS_PATH is properly set to a path that only contains app checkouts that should be shared across multiple stable versions or remove it from your existing .env file to use the default location.

[juliusknorr]

• ✨ New stable27 container has been added for the Nextcloud 27 stable branch
  • To setup your stable environment the usual steps can be followed that are described in the readme for running different stable versions
• 🚚 The standalone container are now able to work with GitHub code spaces. An example to integrate this into an app repository for easier contribution can be found at feat: Add devcontainer and update dev docs deck#4683
• 🐛 Apps that are not possible to be enabled during installation will no longer block the setup forever fix: Make autoinstall wait time configurable and 0 by default #189

[juliusknorr]

• 🐛 The environment variable for changing the XDebug mode has been changed to PHP_XDEBUG_MODE to make sure that the configuration can be changed dynamically again using the script ./scripts/php-mod-config nextcloud xdebug.mode debug. Make sure to adjust your .env file accordingly. (#136)
• 🐘 PostgreSQL auto installation works again for stable26 and up (#161)

[juliusknorr]

• 📶 Talk signaling server and janus are available as a dedicated container now. Setup details can be found in the README. (#204, thanks a lot to @SystemKeeper for the contribution)

[juliusknorr]

• 🔒 PROTOCOL environment variable was added to more easily check and autoconfigure if https is used or not. Make sure to update your .env file to include PROTOCOL=https if you are using SSL/TLS on your dev setup (feat: Switch to protocol environment variable #214)

[juliusknorr]

It has been long time without a changelog, but there had been some that i though are worth to summarize:

Changelog

All notable changes to this project since November 7, 2023.

December 2025

Added

• 🦀 rustfs as alternative s3 storage (a0e60da)
• 🐘 PHP 8.5 container support (2cab524)
• 🔐 Authentik as a service (25b8f25)

Fixed

• 🐛 Remove duplicate minio alias from docker-compose (ff89362)
• 🐛 Remove mariadb-client and move to vim-tiny (a0a4990)
• 🐛 Increase phpmyadmin upload limit (06d90c7)

November 2025

Added

• 🚀 Expose minio for external access (fade46f)
• 🐳 Add noop docker image to replace rwgrim/docker-noop (475b555)
• 🔑 Build own keycloak container (a9be636)

Changed

• ⚙️ Change default minio config to support pre-signed urls (824fd6a)
• 📦 Update quay.io/keycloak/keycloak docker tag to v26.4 (4ece329)

Fixed

• 🐛 Fix missing closing bracket (482cdb5)
• 🐛 Do not force enable blackfire (305e9ab)
• 🐛 Fix env syntax in dockerfiles (a0f2f34)

Documentation

• 📝 Add note about original dockerfile (2fa1347)
• 📝 Update oidc command (8f9831a)
• 📝 Update standalone commands (39b76cf)

Previous months for completeness

October 2025

Changed

• 📦 Bump playwright and @playwright/test in /tests (e05570a)
• 📦 Update actions/setup-node action to v6 (33634df)
• 🔄 Notify push: always use latest released version (f3c9905)
• ⬆️ Bump min php version (2ed579d)

CI/CD

• 🔧 Only start containers for testing (7b9d9bc)
• 🔧 Properly start container with 8.4 for playwright (c9680f5)
• 🔧 Bump php requirements for playwright tests (0251f2e)

September 2025

Added

• 🐘 Add stable32 support (e140b45)

Changed

• 📦 Bump actions/setup-node from 4 to 5 (b143523)
• 📦 Bump actions/setup-python from 5 to 6 (902d927)
• 📦 Bump actions/upload-pages-artifact from 3 to 4 (6291dd3)

August 2025

Changed

• 📦 Update actions/checkout action to v5 (0e2d2b2)
• 🔄 Bump notify push version (00405f5)

Fixed

• 🐛 Make the SAML config works with the default config (a06077f)
• 🐛 Change default nextcloud url to nextcloud.local (8ad77cf)

Documentation

• 📝 Add a note for https in keycloak docs (8db3d3f)
• 📝 Add basic instructions for notify_push (d354a41)

July 2025

Fixed

• 🐛 Adds the possibility of using rootless Docker (821d4df)

June 2025

Changed

• 📦 Update ubuntu docker tag to v24 (f7c23b8)
• 📦 Update quay.io/keycloak/keycloak docker tag to v25 (1a91477)
• 📦 Update docker/build-push-action action to v6 (e3fe37c)
• 📦 Update elasticsearch docker tag to v7.17.22 (89056b2)

Fixed

• 🐛 Install latest node (6657a11)
• 🐛 Workaround for running latest onlyoffice (94dd17a)
• 🐛 Run on newer ubuntu (a237d56)
• 🐛 Fix bootstrap.sh error message when docker-compose is not installed (ba19e35)

Tests

• 🧪 Fix playwright selector (3b0ecdd)
• 🔧 Skip playwright tests for PHP 8.0 (8bfdc12)

Added

• 📦 Add a symbolic link for phpunit (50d1c0b)
• 🐘 Add excimer php extension (b8e5fbf)

Documentation

• 📝 Add note about updating the Nextcloud installation (560d601)
• 📝 Update s3.md (d0cd17b)

May 2025

Changed

• 📦 Update redis docker tag to v8 (225b224)
• 📦 Update elasticsearch docker tag to v7.17.21 (5542f4d)

Fixed

• 🐛 Remove obsolete version attribute (2929aae)
• 🐛 The aio images moved to ghcr.io (eb06339)
• 🐛 Proper check for standalone container (cf972bd)

April 2025

Added

• 🐘 Add support for stable29 (e04299f)

Changed

• ⚙️ Update mysql wait_timeout to the default value (752ff8a)
• 📦 Update elasticsearch docker tag to v7.17.19 (7484705)
• 📦 Bump actions/configure-pages from 4 to 5 (a688898)

March 2025

Changed

• 📦 Update quay.io/keycloak/keycloak docker tag to v24 (eab8aa8)

February 2025

Added

• 📧 Provide IMAP-Server (53286dc)
• ✅ Check if installation was successful (e4fd142)
• 🐘 Add stable31 support (cfffb7d)

Fixed

• 🐛 Fix compatibility with bash < 4.4 (30e1ba5)
• 🐛 Added missing parameter to app_api occ commands (faf764e)
• 🐛 Ping onlyoffice server image to previous version (24a33af)

Changed

• 🚫 Remove imagick from PHP extensions (81c0256, 815d522)
• 📦 Use imagick from master (aa873ad)
• 🔧 Use latest node (acc1959)

CI/CD

• 🔧 Try downgrading qemu (d065043)
• 🔧 Run tests only on existing image tags (29fbf5a)
• 🔧 Tag locally to run tests for new images (8e7322b)
• 🔧 Go back to ubuntu 22.04 (2a93fea)

Documentation

• 📝 Simplify the text (4dd0949)
• 📝 Extend section about 'Apps without stable branches' (5bba062)
• 📝 Update bootstrap.sh: $PWD might contain whitespace (64bcfa9)
• 📝 Add git command to fetch stable version (56c9b43)

January 2025

Added

• ⚖️ Create LICENSE (4de99ff)
• 📁 Added unnamed volumes for apps-writable and redis (5e956a0)
• 🎙️ Add talk recording server (2d37ab2)

Changed

• 📦 Update quay.io/keycloak/keycloak docker tag to v26.1 (3e79244)
• 📦 Update elasticsearch docker tag to v7.17.17 (d9d3974)
• 📦 Update actions/cache action to v4 (57f577a)

Fixed

• 🐛 Fix non-string parameters for talk-recording (6e17055)
• 🐛 Adjust php settings for talk-recording (1ac9477)
• 🐛 Fix volume mounts for nextcloud2 and nextcloud3 (78fb235)
• 🐛 Fix missing ending template tags on Overview page (b2a76fc)
• 🐛 Fix properly start postgres (bf91888)
• 🐛 Make object storage autosetup work again (bb86352)

Documentation

• 📝 Update stable-versions.md (03ca6ee)

December 2024

Added

• 🐘 Add php8.4 container (533ed2d)
• 🛠️ Add nano to tools (733dc06)
• 🌐 Add support for nginx vhost config drop-ins (8f96207)
• 🌐 Add tinyproxy container (d36dd92)

Changed

• 📦 Update actions/upload-artifact action to v4 (aa2ba09)

Fixed

• 🐛 Use xdebug beta until final for 8.4 is out (807ac40)
• 🐛 Bind published ports to 127.0.0.1 by default (6ff8cf9)
• 🐛 Skip blackfire for now (6760ee0)
• 🐛 Use PROTOCOL var when enabling the talk HPB (e580aa3)
• 🐛 Force enable richdocuments app (4ddcec9)

CI/CD

• 🔧 Make artifact names unique (cea7785)
• 🔧 Fix shellcheck opts (4a126e2)
• 📦 Bump actions/upload-pages-artifact from 2 to 3 (e44f779)
• 📦 Bump actions/deploy-pages from 3 to 4 (021b499)

Enhancements

• ✨ Auto dark mode in installing status page (40dc31e)

Documentation

• 📝 Extend s3 docs (7f814e2)
• 📝 Fix external storage config in s3 docs (53f2f99)

Fixed

• 🐛 Fix auto provisioning script to have a proper storage url for OnlyOffice (ca58146)
• 🐛 Add missing functions.sh (ff272e6)
• 🐛 Move from docker-compose to docker compose by default (d8596f8)

Changed

• 🔧 Add docker compose support in bootstrap (c6cde44)
• 🔄 Revert "chore(deps): update alpine docker tag to v3.19" (d25f34a)
• 🔧 Change order of xdebug/blackfire installs (5143ab1)
• 🔧 Use xdebug default version (b152850)
• 🔧 Do not warn about missing optional parameters (b1a61e5)

Documentation

• 📝 Fix typos and grammar (498e2d7)
• 📝 Update onlyoffice docs (c102f3a)
• 📝 Add small hint about oracle sqlplus (cecb01c)

November 2024

Changed

• 📦 Update alpine docker tag to v3.19 (fd359a7)
• 📦 Update actions/setup-python action to v5 (73da941)
• 📦 Update quay.io/keycloak/keycloak docker tag to v23 (55aa6d8)

Fixed

• 🐛 Add fallback for sqlite for availability check (a1c8f54)

October 2024

Added

• 🗄️ Add basic support for Oracle DB (855cfa4)

Changed

• 📦 Update elasticsearch docker tag to v7.17.25 (62ae5c4)
• 📦 Update quay.io/keycloak/keycloak docker tag to v26 (d55dad8)
• 📦 Update ghcr.io/gvenzl/oracle-xe docker tag to v21 (dc09074)

Fixed

• 🐛 Update broken links (5759f8a)
• 🐛 Update dsp links after repo transfer (a7998b3)

September 2024

Added

• 📝 Added some documentation on the various NC cloning methods (9221e7e)

Changed

• 📦 Update elasticsearch docker tag to v7.17.24 (99191f1)

Fixed

• 🐛 Fix typo boottrap -> bootstrap (6d7d879)
• 🐛 Fix using --clone-no-blobs (2f45387)
• 🐛 Fix doubled depth filter (173c223)

Documentation

• 📝 Remove some typos (73747b3)
• 📝 Apply suggestions from code review (988061d)
• 📝 Fix a MD typo (7ded1e9)
• 📝 Fix typo for recording server (6db0062)

August 2024

Added

• 🐘 Add stable30 support (9bf907e)
• 🚀 Add appapi-dsp/appapi-dsp-https service (c408686)

Changed

• 📦 Update elasticsearch docker tag to v7.17.23 (35609a7)
• 🔧 Only install latest node lts (c9f88ba)

Fixed

• 🐛 php80 is not accepted by latest nextcloud (35960f5)
• 🐛 Add also occ cli alternative way to register (26647d4)

December 2023

Added

• 🐘 Add php 8.3 container (d8d7a06)
• 🐘 Add container for stable28 (12c7107)
• 🪝 Add hooks for nextcloud containers (18e63ac, #5)
• 🧪 Add simple playwright login test (76676aa)
• 🗄️ Add mariadb primary/secondary cluster (WIP) (5049660)
• 📝 Add database docs (2786901)
• 🔧 Add CLI parameter parsing to bootstrap script (b045f88)
• 📝 Added script to fetch full clones (853e7f9)

Changed

• 📦 Update quay.io/keycloak/keycloak docker tag to v23 (55aa6d8)
• 📦 Update actions/setup-node action to v4 (5a6ef75)
• 📦 Update actions/configure-pages action to v4 (57726da)
• 📦 Update actions/deploy-pages action to v3 (29d78d5)
• 📦 Update actions/checkout action to v4 (03b5c18)
• 📦 Update actions/setup-python action to v4 (38fc67b)
• 🔧 Bump node version in containers (c676449)
• 🔧 Cleanup config handling (71fc8c5)

Fixed

• 🐛 Remove blackfire default config (66d84c1)
• 🐛 Stick to previous xdebug version (b8fbafd)
• 🐛 Fix onlyoffice secret (85f756d)
• 🐛 Cleanup docker-compose (0e768bf)
• 🐛 Prepare xdebug config for trace flamegraphs (f56d76c)
• 🐛 Use github ref name (d6b30a0)
• 🐛 Use github ref as tag (0ea040a)
• 🐛 Show progress during clone (4118e9b)
• 🐛 Setup hosts during bootstrap and print debug info for existing installations (e6116ac)
• 🐛 Bring back memcached php extension (3c06fe3)
• 🐛 Clone circles on fresh setups (6705dd9, #236)
• 🐛 Comment out paths in example config (a5f404a, #174)
• 🐛 Throw error if no source code found (42925f4, #169)
• 🐛 Blackfire enabling script (709fbd9)
• 🐛 Switch release and latest tags (18e065f)

Enhancements

• 🚀 Change to two channels for images (release and latest) (9ae5046)
• ✨ Easy editing of config from outside (b29a0cc)

Documentation

• 📝 Start separate docs build (3b9ec4f)
• 📝 More docs (a72e27b)
• 📝 Update gitignore (cc21092)
• 📝 Fix docs build on push (0454d2c)
• 📝 Reference tutorial in the README (9854a3c, #70)
• 📝 Hint to the new docs in README (ccccc6b)
• 📝 Move all docs (b777c14)
• 📝 Update README.md (15b98dc)
• 📝 Fix docs action (eab103d)
• 📝 Cleanup npm version (09f8437)

CI/CD

• 🐛 Fix mariadb-client to containers (6afcd1b)

November 2023

Changed

• 📦 Update README.md (c11f473)