--- title: "Understanding files" date: "2024-02-14T06:18:38+00:00" summary: "Learn how Cloud Platform manages files separately from your Drupal database and code for better performance and easier workflows." image: type: "page" url: "/acquia-cloud-platform/understanding-files" id: "23a18185-a300-427c-9b84-6f6222a5ad94" --- Table of contents will be added On Cloud Platform, uploaded files are separate from the Drupal database and your code repository. Cloud Platform deployment code creates a symbolic link to your application’s `/files` directory. If you use Drupal’s multisite feature, Cloud Platform creates a separate `/files` directory for each `settings.php` file in the `/sites` directory. Drupal codebases (including Drupal core, contributed modules, and custom code) on Cloud Platform are managed using the Git version control system. Git can manage text files full of code, but is not suitable for large collections of user-uploaded objects. Cloud Platform stores your application’s `/files` directories outside of your repository and manages them for you. This simplifies your workflow and makes your repository smaller and more manageable. To access your application’s `/files` directories, use the `sftp`, `scp`, `rsync`, or `ssh` commands. For more information, see [Disk Storage on Cloud Next](/acquia-cloud-platform/manage-apps/infrastructure/storage/cli). Cloud Platform Enterprise applications run on high-availability infrastructure for their live production environments. For environments running on [Cloud Next](/acquia-cloud-platform) technologies, this applies to non-production environments, as well. If the application is configured to use local file storage, files uploaded to any one underlying application-layer node won’t be available to other nodes handing traffic for your application. This is why Cloud Platform Enterprise environments use shared file systems to ensure that data written to a `/files` directory is accessible to all infrastructure nodes running your application’s code. Production environments on Cloud Platform Enterprise applications run on multiple application-layer nodes simultaneously, ensuring high-availability of application infrastructure. Non-production environments running on Cloud Next technologies also utilize high-availability application-layer infrastructure. If an application is configured to use local file storage, files uploaded to one web node would not be available on another. Cloud Platform Enterprise uses shared file systems to ensure that data your code writes to a `/files` directory is accessible on all web nodes running your application’s code. When you import or create your Drupal codebase, Cloud Platform creates symbolic links to your public file directory. Every Drupal multisite website in your account has its own `/files` directory. * `[docroot]/files` links to `/mnt/files/[site].[env]/files` * `[docroot]/sites/default/files` links to `/mnt/files/[site].[env]/sites/default/files` * `[docroot]/sites/example.com/files` links to `/mnt/files/[site].[env]/sites/example.com/files` To ensure its privacy, the `/files-private` directory is not symbolically linked to your application’s `[docroot]`. For private file handling, you can either use the absolute path to `[docroot]` or a relative path under `../acquia-files`. For more information, see [Setting the private file directory on](/acquia-cloud-platform/help/93091-setting-private-file-directory-acquia-cloud "Setting the private file directory on Acquia Cloud") Cloud Platform. Handling large files -------------------- Warning Using extremely large files can cause problems on your application.  Large images can increase page load times, causing a perceived performance issue for your visitors. Additional problems can include having files that are too large for your application’s Varnish® cache, and that uploading large files through Drupal can fail due to timeouts at various levels of the stack. If, however, you need to use extremely large files, consider these resources and factors: * To allow file uploads up to 1 GB in size through the Cloud Platform user interface, access an environment's **Configuration** > **Advanced Configuration**. * If you find that uploads of large files to Cloud Platform Enterprise are timing out or otherwise failing, see [Correcting broken uploads](/acquia-cloud-platform/manage-apps/files/broken) on Cloud Platform Enterprise. * Read [Handling large files](/acquia-cloud-platform/help/93236-handling-large-files "Handling large files") for best practices about image processing, file organization, and storage. ### Downloading large files Drupal applications on Cloud Platform support downloading of files of any size. However, large downloads require a correct `Content-Length` header in the HTTP response in order to succeed. For any static file, the Apache process in the Cloud Platform stack will provide the correct header. If the download is large (1 GB or greater) and is dynamically generated (for example, generated by a PHP script), the download is likely to fail unless a `Content-Length` header is explicitly provided. Large numbers of files ---------------------- If you maintain an extremely large number of files in your application, it can have a substantial negative effect on performance and stability, especially if they are all contained in the same directory. Acquia has found that having over 2,500 files in any single directory in the files structure, or a total of 250,000 files across all directories for environments running on Cloud Classic technologies, can seriously impact your infrastructure’s performance and potentially its stability. If your application requires a large number of files, maintain them in multiple directories. For more information about files and performance, see [Improving application performance](/acquia-cloud-platform/improving-application-performance "Improving application performance"), [Proactively organizing files in subfolders](/acquia-cloud-platform/help/94276-proactively-organizing-files-subfolders "Proactively organizing files in subfolders"), and [Optimizing file paths: Organizing files in subfolders](/acquia-cloud-platform/help/93016-optimizing-file-paths-organizing-files-subfolders "Optimizing file paths: Organizing files in subfolders"), which includes scripts for migrating files into subdirectories in your file system. Storing more than a terabyte of files ------------------------------------- For environments running on [Cloud Next](/acquia-cloud-platform#cloud-next-benefits) technologies, there is no practical limit to how much storage is available, although Acquia strongly recommends keeping environments under 1 TB in total file system size in order to ensure file copy operations and disaster recovery processes can both be completed in a timely manner, when required. For environments running on Cloud Classic technologies, Cloud Platform uses Amazon Elastic Block Stores (EBS) for an application’s files directory. Since EBS volumes can be no larger than 1 terabyte, Acquia recommends using [Amazon’s S3 storage service](http://aws.amazon.com/s3/) if you require more than 1 terabyte of file storage. Amazon S3 is highly reliable and can scale to any size storage. For Drupal 7 applications, you can use the [AmazonS3](https://www.drupal.org/project/amazons3) module, which uses the Drupal file wrapper to send files directly to and from S3. For more information, see [Using external storage for files](/acquia-cloud-platform/help/93236-handling-large-files "Handling large files"). File execution restrictions --------------------------- Files in your application’s file storage are not executable by Cloud Platform PHP processes. Related Topics -------------- * [Importing your files](/acquia-cloud-platform/create-apps/import/manual/manual-files) * [Working with files](/acquia-cloud-platform/manage-apps/files) * [About Drupal multisite installations](/acquia-cloud-platform/develop-apps/drupal-apps/multisite-installation) * [Cloud Platform Enterprise availability and disaster recovery](/acquia-cloud-platform/architecture/security/availability) * [Monitoring and support](/acquia-cloud-platform/architecture/security/monitor)