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