Managing Server Storage
If the storage included with your server plan is no longer sufficient, Frappe Cloud allows you to add additional storage whenever required. Additional storage is billed at $0.20 per GB per month.
Important
On AWS, storage volumes can only be expanded and cannot be reduced later. If you no longer need the extra storage, the recommended approach is to create a new server with the desired storage size and migrate your sites.
Adding Storage Manually
You can increase your server storage at any time from the Frappe Cloud dashboard.
- Open the Servers page.
- Locate the server that requires additional storage.
- Click the + button next to the server.
- Select the amount of storage you want to add.
- Confirm the operation.
Note: After increasing storage, you must wait 6 hours before adding more storage to the same server.
Automatic Storage Expansion
To help prevent downtime caused by low disk space, Frappe Cloud can automatically increase server storage when required.
This automatic expansion helps avoid issues caused by full disks, including application interruptions and Redis failures.
Disable Automatic Storage Expansion
If you prefer to manage storage manually, you can disable automatic storage expansion.
- Open the Servers page.
- Click the Settings (Spanner) icon next to the server.
- Clear the Enable Auto Add-on Storage option.
- Click Confirm.
Note
If automatic storage expansion is disabled, Frappe Cloud will no longer increase storage automatically when disk usage becomes critical. Any downtime caused by insufficient disk space becomes the server owner’s responsibility.
Frequently Asked Questions
Why is application server storage larger than the combined storage of all sites?
The application server stores more than just website data.
Storage usage also includes:
- Bench Groups.
- Application source code.
- Python packages and dependencies.
- Docker images and containers.
- Docker cache.
After deleting a Bench Group, storage may not reduce immediately because Docker cache remains until the scheduled cleanup process runs, which typically happens within six hours.
Why does storage usage increase during bench or site updates?
During updates, Frappe Cloud creates temporary table-level backups inside the .migrate directory. These backups allow migrations to be rolled back safely if an error occurs.
Additional storage is also temporarily consumed because:
- Migration backup files are created.
- New Docker images are downloaded.
- Updated application code is stored alongside existing versions until cleanup completes.
To reduce temporary storage usage, consider updating sites one at a time instead of updating multiple sites simultaneously.
Warning
Do not manually modify or delete files inside the .migrate directory. These files are required for migration rollback and removing them may result in data loss.
Why does storage sometimes increase beyond the configured limit?
Automatic storage expansion is triggered whenever disk usage exceeds approximately 90% of the available capacity.
Each automatic expansion increases storage independently. At present, Frappe Cloud does not enforce an overall maximum limit for automatic storage increases. This behavior prioritizes service availability by ensuring servers do not run out of disk space.
How do I remove unused files from the server?
If your server contains old bench versions or unused deployment files, you can trigger a cleanup operation manually.
- Open the server dashboard.
- Select Server Actions.
- Click Cleanup Server.
This removes unused deployment artifacts and older bench versions, helping reclaim storage after multiple updates.
Best Practice
Monitor storage usage regularly and perform server cleanup after major deployments. Enable automatic storage expansion for production servers to reduce the risk of outages caused by low disk space.
