Migrate Storage Locations

You may want to migrate files from one local storage location to another, or from an existing storage location to an Amazon S3™ bucket or a compatible service.

Migrating Email Attachments

The system cannot automatically migrate email attachments (as opposed to email template attachments). You upload these files when creating a custom email message, and they are transient.

  • To avoid any inconsistencies when switching storage settings for email attachments, make certain that no admins are currently composing an email message with attachments.
  • Email template attachments are a separate asset type that you can migrate automatically.

Manual Migration

Instead of using automated migration, you may opt to migrate your files manually and switch the relevant file type’s storage setting immediately.

  • This will skip automatic migration. You assume responsibility for moving the files to the new location.
  • WHMCS may store some file types in the same folder (for example, client files, email, ticket attachments, and project management files are in the attachments folder). If you decide to move all of the files away from that folder, you must move all relevant file types.

Manual Amazon S3 Migrations

For manual migrations, the system stores files in Amazon S3 with a prefix corresponding to the file asset type. For example, it will store file1.png, a client file, as /client_files/file1.png. Use the following subdirectory names:

File TypeDirectory Name
Client Filesclient_files
Email Attachmentsemail_attachments
Email Template Attachmentstemplate_attachments
Project Management Filespm_files
Ticket Attachmentsticket_attachments
When using automatic migration, the system manages these prefixes automatically.

Common Errors

A File not found error indicates that a file is not present or is not accessible at the expected location.

For steps to troubleshoot this, see Troubleshooting a File Not Found Error.

Last modified: June 11, 2024