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:

Common Errors #

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

Last modified: June 14, 2024