Pantheon Filesystem

Detailed information on how to access and optimize the Pantheon filesystem.


Files are user uploads, usually images or documents. They are excluded from version control via Pantheon's .gitignore files:

The Pantheon architecture is comprised of 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 symbolically links the wp-content/uploads directory for WordPress and the sites/default/files directory for Drupal to the Valhalla files directory mount point, /files if viewed via an SFTP client. It is important to note that this directory is not part of the document root and is not directly web-accessible. Should you wish to make this accessible, you will 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.

Access via SFTP

You can connect directly to the filesystem by copying your connection information into popular SFTP clients such as Filezilla and navigating to the /files directory.

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 wp-content/uploads.

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.

Troubleshooting

Migrated WordPress sites errors

The Pantheon WordPress upstream uses the default Media Upload path (wp-content/uploads). Using any other path will result in errors.

Simultaneous SFTP Connections

Pantheon does not support simultaneous SFTP connections. To avoid errors, set your SFTP client to use no more than 1 simultaneous conection.

Unable to create directory . Is the parent directory writable by the server?

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:

  1. In the WordPress Admin Dashboard and go to Settings > Media (/wp-admin/options-media.php)
  2. Go to Uploading Files > Store uploads in this folder and update the field to contain wp-content/uploads only.
  3. Optional: Ensure there is no defined setting in wp-config.php i.e.; define(‘UPLOADS’, ‘wp-content/myimages’);.