Disks

Disks are the physical location that media is stored.

There are two places where the Disk can be specified:

• In the Enso config, as enso.media.disk - This is the one Enso interacts with.
• In the standard laravel config, as filesystems.default.

The options for this setting are available as the keys of the filesystems.disks array.

Depending on your chosen disk, there may be additional setup required. See Laravel Documentation for details.

Transfering files

If you are changing the Disk for a site after it has been put live and has had images uploaded, you will need to transfer the files from their previous disk to the new one to keep everything available. This can be done in advance. Enso provides an artisan command for this.

php artisan enso:transfer-files old_disk new_disk

This command will run over the files table and pull any files from their path on the old_disk and transfer them to the same path on the new_disk. In the case of images, the command will also iterate over the image presets list and check for existing image resizes, transfering them as well.

Notes:

Given that this finds files through their database entries, this does NOT transfer files that are not imcluded as part of the Enso Media library.

This process DOES NOT automatically delete files from the old disk. When you are happy that the new disk has the files that you need, remember to delete the old ones.