Frequently Asked Questions

Find answers to common questions and issues related to Frappe Cloud sites, billing, storage, backups, performance, and configuration.

Why is my site in an Inactive state but still getting billed?

Both Active and Inactive sites are billed. To stop billing, you must permanently drop the site from your Frappe Cloud account.

Why is my site suspended?

Your site can be suspended for one of the following reasons:

• Unpaid invoices – Pay the pending invoices from the Billing section to restore access.
• Trial expired – Upgrade to a paid plan to continue using the site.
• Storage limits exceeded – If your disk or database usage remains above the plan limits for more than 7 days, the site is automatically suspended.

To restore the site, either:

• Upgrade to a higher plan.
• Reduce disk usage by deleting unnecessary files, media, backups, or unused assets.
• Reduce database usage by archiving or deleting old records and optimizing your database.

What is using all of my database storage?

You can identify which tables or DocTypes consume the most database space by opening the Database Storage Report from within your site.

Cleaning Log Tables

Log tables often consume a significant amount of database storage. You can reduce their size using the Log Settings page.

• Add supported log DocTypes for automatic cleanup.
• You can safely include DocTypes like Deleted Document.
• Cleanup runs once every day, so storage changes may not appear immediately.

Cleaning Comments and Versions

What is the difference between Database and Disk space?

Business data such as invoices, customers, and transactions consume database space, while uploaded files, images, and attachments consume disk space.

Destination bench group does not have some of the required apps

If you’re updating a site on a public bench and receive this error, it usually means one or more Marketplace apps are no longer available on public benches.

To resolve the issue, either:

• Remove the unused Marketplace app from your site, or
• Create a Private Bench Group, install the required apps there, and migrate your site.

Why did my database size increase after moving to a dedicated server?

Dedicated server storage includes the entire database server usage, not only your database. This includes binary logs and other database-related storage, so the reported size can be larger than what was shown on shared hosting.

Row size too large error during migration

pymysql.err.OperationalError:
(1118, 'Row size too large...')

This error is usually caused by having too many Data custom fields in a single DocType.

To resolve it, convert large Data fields to one of these field types:

• Small Text
• Text
• Password
• Attach
• Attach Image

Data truncated for column during migration

pymysql.err.DataError:
(1265, "Data truncated for column...")

This happens when a field’s data type has been changed to one with a smaller storage capacity, such as changing Text to Data.

To fix this:

• Create a migration patch to preserve existing data.
• Or revert the field type change.
• You can also manually update the affected records before migrating.

Administrator password is not working after restoring a site

You can log in as the Administrator directly from your Frappe Cloud dashboard.

If you need the updated Administrator password, you can request it through the Frappe Cloud support portal.

Apps are missing after restoring a backup

Restoring a backup completely replaces your site’s database with the contents of the backup.

If the backup was created before certain apps were installed, those apps will no longer appear after restoration.

Cannot embed my site inside an iframe

This happens because of the default X-Frame-Options security header.

If you use a private bench with a custom app, you can configure a Content-Security-Policy header using the after_request hook.

CORS error while calling APIs

To allow requests from another website or localhost, configure the allow_cors value in your site’s Site Config.

Add all allowed origins separated as required by your configuration.

Scheduler is not running

If scheduled jobs are not executing:

• Check the RQ Job DocType (or Open Background Jobs on older versions).
• Verify the Run Jobs only Daily if Inactive For (Days) setting in System Settings.

If no users log in for the configured number of days, scheduled jobs will run only once per day.

Need a 4096-bit HTTPS certificate

The default shared domains use 2048-bit certificates.

If you require a 4096-bit certificate, first configure a custom domain and then contact Frappe Cloud support to request a certificate upgrade.

Where can I find my inbound and outbound IP addresses?

Both IP addresses are available on your site’s Overview page.

• Outbound IP is used for whitelisting your site with third-party services.
• Inbound IP is used when creating DNS A records for your domain.

Page Unresponsive

This error usually indicates a problem on the client side, such as excessive browser memory usage or a JavaScript memory leak.

Review your custom client scripts or browser extensions if you encounter this issue.

How do I get the MariaDB root password?

You cannot access the MariaDB root password on Frappe Cloud.

Administrative tasks such as creating or deleting sites should always be performed through the Frappe Cloud dashboard.

Can I restore a dropped site?

Yes. Open your Sites list and change the status filter to Archived. From there, you can access previous backups and restore them to another site.

Outgoing requests are blocked

Frappe Cloud does not restrict outgoing network requests.

If requests fail, verify that the destination server allows connections from your site’s outbound IP address.

Error while installing ERPNext

ERPNext can only be installed on a fresh site before the Setup Wizard has been completed.

If required, reset your site’s database from:

Site Dashboard → Actions → Dangerous Actions → Reset Site

A job is taking too long

Long-running jobs are often caused by database migrations or large schema changes.

Check the process list or allow the operation additional time to complete before assuming it has failed.

How do I change the notification email for a site?

Open your site’s Activity tab and update the notification email from there.

India Compliance credits are incorrect after restoring a backup

Log out of your India Compliance account and log back in. This refreshes the displayed credit balance.

Can I change the system timezone?

The system timezone cannot be changed after it has been configured.

You can, however, set a different timezone for individual users through their User Settings.

How can I increase the database size on shared hosting?

Database capacity cannot be increased separately on shared hosting.

Upgrade your site to a higher plan or reduce storage usage using the Database Analyzer and Log Settings.

How do I deactivate my site?

From your site dashboard, enable Maintenance Mode to deactivate the site.

While deactivated, the site remains inaccessible but billing continues until the site is permanently deleted.

I cannot upload large attachments

The default upload limit is 10 MB.

You can increase this limit by setting the max_file_size option in your Site Config.

How do I reset my site to a clean state?

Navigate to:

Site Dashboard → Actions → Dangerous Actions → Reset Site