Learn more about Pantheon's Filesystem.Discuss in our Forum Discuss in Slack
Files are static content not stored in your database, and usually consist of images, documents, or user uploads. Files are distinct from your site's code, and are excluded from version control via Pantheon's
.gitignore files :
Files and Application Containers
The Pantheon architecture relies on 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:
It is important to note that this directory is not part of the document root and is not directly web-accessible. You must create an additional symbolic link from within the document root if you need to make a path in
files accessible from the docroot. Non-standard file locations must be symbolically linked to
/files or moved manually.
Access via SFTP
You can connect directly to the filesystem with an SFTP client, such as WinSCP.
Copy your connection information into an SFTP client.
Navigate to the
/filesdirectory within the SFTP client.
Pantheon places the files below in your application container because they contain important information:
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.