Local October CMS docker image & update to v4

chocolata · August 2, 2025, 11:21am

Hi,

I’ve previously installed the interactive bash script to install my local testing environment, and now I’d like to update to v4 from v3. In the upgrade guide it says that first we need to make sure that we’re on PHP version 8.2. The docker image seems to be fixed to PHP v8.1.

I’ve tried pulling the image in again, but that too seems to be fixed to PHP v8.1.

What would be the best way to upgrade our local testing environment to October CMS v4?

Thanks.

daft · August 24, 2025, 9:55am

Hey @chocolata

Version 4 was rolled out to composer users first. We plan to update the docker image next month.

syl-via · September 5, 2025, 5:36pm

Hey @chocolata
You can also use this image:

github.com

octobercms/install/blob/master/Dockerfile

#
# October CMS installer
#
# Create image with:
#   docker build -t myoctober:latest .
#
# Open installer with:
#   http://localhost:port/install.php
#
FROM php:8.2-apache
LABEL maintainer="October CMS <hello@octobercms.com> (@octobercms)"

# Installs dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
    unzip \
    wget \
    libfreetype6-dev \
    libjpeg62-turbo-dev \
    libpng-dev \
    libyaml-dev \

This file has been truncated. show original

but remove the libzip4 library, which is not working.
Then, inside the container, run the composer command:

composer create-project october/october myoctober .

Good luck

chocolata · October 15, 2025, 9:25am

Hi @daft , is there any update on this?

The docker image is still locked to version 3.

We can’t really move forward without a solid local development environment for version 4.
Thanks for looking into this.

daft · October 15, 2025, 9:26am

The image should have been updated to v4 already. Did you pull the latest image?

chocolata · October 15, 2025, 9:35am

Hi @daft

Sorry, I was basing myself on the documentation that is apparently behind…

Just tested it out and I am on October CMS v4 locally!
Thanks a bunch.