October CMS 4.0 Beta - Install Guide

[daftspunk]

The upgrade to Laravel 12 is ready with October CMS Version 4. Help us test it by upgrading your version 3 installation using these instructions. Please report any issues to this repository.

---

PHP Minimum Version

Make sure you are using the new minimum PHP version 8.2 or above.

Beta Version

To receive developer updates of October CMS, change the minimum stability setting to dev.

composer config minimum-stability dev

Configuration Files

Some configuration files have been updated. The following files should be updated to use the latest content. It is best to compare them with your current configuration files to be sure they are the same.

• config/app.php

The following commands will replace the files with their latest contents:

curl -o ./config/app.php https://raw.githubusercontent.com/octobercms/october/refs/heads/4.x/config/app.php

Bootstrap Files

Some bootstrap files have been created and updated. The following files should be created or updated to use the latest contents:

• bootstrap/app.php
• bootstrap/providers.php

The following commands will replace the files with their latest contents:

curl -o ./bootstrap/app.php https://raw.githubusercontent.com/octobercms/october/refs/heads/4.x/bootstrap/app.php
curl -o ./bootstrap/providers.php https://raw.githubusercontent.com/octobercms/october/refs/heads/4.x/bootstrap/providers.php

Composer Dependencies

Update the following dependencies in your application's composer.json file:

• october/all to 4.0.x-dev
• october/rain to 4.x-dev
• laravel/framework to ^12.0

If you are including individual modules, these can be updated to be the dev-develop version.

Once this file has been updated, you may run composer update to perform the upgrade. In most cases everything should update smoothly. Don't forget to migrate the database with the php artisan october:migrate command.

Note: For any errors or support with upgrading packages, you may reach out on the Community Forum.

[daftspunk]

Hi @Dheia

Please create a new issue instead of posting on this announcement. Thank you.

[daftspunk]

Hi @alexbog8

Please create a new issue instead of posting on this announcement. Thank you.