Files are large pieces of static content not stored in your database, usually images, documents, or user uploads. Because they are distinct from your site's code, they are excluded from version control via Pantheon's
.gitignore files :
The Pantheon architecture comprises highly available application containers that are seamlessly integrated with Valhalla, our cloud-based filesystem. This means that your files are not local to the application containers running your site's codebase.
Valhalla creates a symbolic link (symlink), to the
files directory in the appropriate location of your docroot (
wp-content/uploads for WordPress and
sites/default/files for Drupal).
It is important to note that this directory is not part of the document root and is not directly web-accessible. If you need to make a path in
files accessible from the docroot, you need to create an additional symbolic link from within the document root. Any non-standard file locations should be symbolically linked to
/files or moved manually.
When you are logged in to your application container, you may notice some files that you don't recognize. Don't worry—we put them there, and here's why:
fusedav_version: shows the version of fusedav being used.
fusedav.conf: is the client configuration file for fusedav. fusedav is software used to mount shared storage (the folder /files) to the application container. This folder is where your content-related files (images, attachments, and other things not stored in version control) are kept. For Drupal sites, there is a symlink to it from
sites/default/files. For WordPress sites, there is a symlink from
htpasswd: is used when you want to lock your environment with a username and password. There is a Public button on each environment Dashboard that you can click to add a username and password to your site. This will keep your site hidden while you're working on it.
The Pantheon WordPress upstream uses the default Media Upload path (
wp-content/uploads). Using any other path will result in errors.
Pantheon does not support simultaneous SFTP connections. To avoid errors, set your SFTP client to use no more than 1 simultaneous connection.
Sites migrated from other hosts may have custom or absolute paths in the "Store Uploads in This Folder" configuration. This can be resolved by using the recommended configuration:
- In the WordPress Admin Dashboard and go to Settings > Media (
- Go to Uploading Files > Store uploads in this folder and update the field to contain
- Optional: Ensure there is no defined setting in
File names and permissions are set by the system and cannot be changed.
Some modules or plugins might return the following error:
User notice: Key file "file:///files/private/public.key" permissions are not correct, recommend changing to 600 or 660 instead of 770 in League\OAuth2\Server\CryptKey->__construct() (line 59 of /code/vendor/league/oauth2-server/src/CryptKey.php)
If you try to change the file permissions to
660 via SFTP, the change will fail silently. The platform will not update the file permissions and will not return an error.