Documentation

• Welcome
• User guide
• Admin guide
• FileRun homepage
• Changelog
• Contact us

Install

• Requirements
• Install guides
• Docker installation
• Manual installation
• PHP configuration
  • PHP compatibility
  • PHP upgrade
  • ionCube loader
• Troubleshooting
• Reverse proxies
• Securing FileRun
• Server optimization

Configure

• Setting the time zone
• System settings
• Sign-in and passwords
• User sign-up
• Storage quotas
• Data retention
• File settings
• Enabling thumbnails and preview
  • Troubleshooting thumbnails
• E-mail notification system
• File preview options
  • File plugins
• File indexing
• Authentication integration
  • OpenID Connect
  • Authentik
  • OAuth2
  • LDAP
  • Active Directory
  • SimpleSAMLphp
  • Microsoft Entra ID
  • Google
  • Dropbox
  • Box.com
• Two-factor authentication
• Advanced configuration

Customize

• Branding
• Theme colors
• Favicons
• Custom CSS
• Translating FileRun
• Custom event scripts

Using FileRun

• File searching
• Metadata
• Organizing files
• Collections
• The media libraries
• The trash
• File-based activity logs
• Screenshot sharing
• Guest accounts
• Your account settings
  • App passwords

Access methods

• Desktop sync
• Mobile apps
• WebDAV

Collaborative editing

• Overview
• Collabora Online
• ONLYOFFICE Docs
• Microsoft 365
• Zoho Editor
• Google Docs Editor

The API

• Introduction
• File paths
• API Methods
• Migrating from an older version
• Changes in 2026.3

Maintenance

• Resetting the superuser password
• Updating FileRun
• Backing up the installation
• Changing database connection information
• Deleting old user files
• Migrating to another server
• Command line tools

• Storage quotas
  • Setting a quota
  • What counts
  • What happens at the limit
  • What users see
  • The Storage usage report
  • Warning users before they reach the limit

Storage quotas🔗

A storage quota limits how much space an account can use. FileRun refuses to store anything that would take an account over its limit.

Setting a quota🔗

The limit is Space quota, next to the home folder Path in the permissions of the account. It is in megabytes, and 0, the default, means no limit.

For an account that has a role, the quota is set on the role, in the same place, and applies to every account with that role. The superuser has no quota.

An independent administrator can give the accounts they manage quotas only within their own quota. See the Administrator's guide.

What counts🔗

The usage of an account is everything in its home folder, plus everything in its trash.

• The trash counts, so emptying it frees space. See The trash.
• Old versions of files do not count, and neither do FileRun's own hidden .filerun. folders.
• A folder shared with the account counts for its owner. When a user uploads into a folder that somebody shared with them, the file counts against the owner's quota, and it is the owner's quota that can refuse it.

What happens at the limit🔗

Anything that would add data beyond the quota is refused: uploads, new files, copies, extracting an archive, creating a Zip archive, and moving items in from another account. The message says how much space is needed and how much is left, or There is no more free space available!.

Lowering a quota below the current usage does not delete anything. The account keeps its files, and everything that would add data is refused until the usage drops below the new limit.

What users see🔗

When an account has a quota, the interface shows the user how much of it is used.

WebDAV clients receive the quota as well, so they can show the free space.

The Storage usage report🔗

Users → Storage usage lists the user accounts with their quota and their usage, in the columns Name, Username, Quota, Used and Percentage used.

The usage is calculated on request, because FileRun has to measure the folders: select an account to calculate its usage, or click Calculate all. A percentage above the warning level is shown in red, and so is the usage of an account that has reached its quota.

Warning users before they reach the limit🔗

Users → Storage usage → Settings has one setting, Users quota warning level, a percentage. The default is 90.

The warning is not sent by itself. The space_quota_notifications.php command produces it, and it has to be scheduled on your server; see Command line tools. Each time it runs, every account at or above the warning level gets a warning, which reaches the user only if:

• the email_notifications.php command runs as well, and
• the E-mail notifications option of the account is on.

Every run warns again, so schedule the command no more than once a day. See The e-mail notification system.