The upgrade process from Cachet v2.4 to v3.x is still in development.

Our goal is to make the upgrade from v2.4 to v3.x as simple as possible. We will provide detailed instructions on how to upgrade from v2.4 to v3.x once the upgrade process is finalized. For now, you’ll need to install Cachet v3.x from scratch or be comfortable with a manual upgrade process.

An important change in Cachet 3.x is that it now relies more on Laravel’s own features and best practises. This means that some configuration options have been removed or changed. We will provide a detailed list of changes in the upgrade guide.

1

Backup your data

Before you start the upgrade process, make sure to backup your database and files. This will allow you to restore your Cachet instance in case something goes wrong.

2

Install Cachet v3.x

We recommend installing Cachet v3.x into a new directory.

Follow the installation guide to install Cachet v3.x on your server.

3

Migrate your data

Once you have installed Cachet v3.x, you can migrate your data from your v2.x instance to the new v3.x instance. Run the following command to migrate your data:

php artisan migrate

The migration path from 2.4 to 3.x is incomplete. Do not run this command without ensuring you have a working backup.

We will provide detailed instructions on how to migrate your data once the upgrade process is finalized.

4

Update your configuration

Cachet v3.x has made some changes to its configuration options. You will need to update your .env file with the new configuration options.

We will provide a detailed list of changes in the upgrade guide.

InstallationIncidents