Skip to content

WordPress (Managed) App

About

This app is targeted at users who want a managed WordPress installation. The Cloudron team tracks upstream WordPress releases and publishes updates. The WordPress code is read-only and you have to extend WordPress using plugins. If you require full control over the installation including editing the WordPress code, use the WordPress (unmanaged) app instead.

Admin page

The WordPress admin page is located https://<my.example.com>/wp-login.php.

Admin user

When using WordPress with Cloudron user management, an admin user is created by default with a random password and the email as admin@cloudron.local. You can delete the admin user post-installation by logging in as a Cloudron admin. It is not deleted automatically because the default posts auto-generated by WordPress installer are assigned to admin.

Administration Email Address

WordPress uses the Administration Email Address to send out important administrative emails. To be able to receive those, make sure to change that address in the Settings section.

Using SFTP

The Managed WordPress app does not support editing files via SFTP. If you require SFTP access to edit WordPress files, use the WordPress (Developer) app instead.

Memory limits

To adjust memory allocated for WordPress, edit /app/data/wp-config.php using the File manager and add the following line at the end of the file:

define('WP_MEMORY_LIMIT', '128M');
define('WP_MAX_MEMORY_LIMIT', '256M');

Note that the app also has a separate memory limit controlled by the app's memory limit. If you increase WP_MEMORY_LIMIT, be sure to increase the app's memory limit. A good formula is to provide the app 6 times the WP_MEMORY_LIMIT value at the bare minimum.

WP_MAX_MEMORY_LIMIT is the limit for administration tasks, which often require more.

A detailed explanation can be found in the WordPress docs.

Cron tasks

The app is configured to run WordPress cron tasks every 5 minutes.

To run the cron tasks manually run the following command using the Web terminal:

wp cron event run --due-now

WordPress' built-in cron task schedule wp-cron is disabled since it is not effective for low traffic websites.

To add custom cron events, use Cloudron's built-in cron or use a plugin like WP Crontrol.

Plugins

Cloudron does not support plugins that modify the code. Code is read-only and immutable. This property is essential for Cloudron to update apps correctly.

Use the WordPress (unmanaged) app as an alternative to install plugins that modify the code.

Disabling plugin

If a plugin is preventing WordPress from starting, open the File manager. Navigate to /app/data/wp-content/plugins and rename the offending plugin directory from plugin-name to say plugin-name-broken.

Note that to enable it back, you have to not only rename the folder but also activate the plugin in the WordPress dashboard.

Disabling all plugins

To disable all plugins, rename /app/data/wp-content/plugins to /app/data/wp-content/plugins-broken using the File manager.

Note that to enable back all the plugins, you have to not only rename the folder but also activate the plugins in the WordPress dashboard.

Performance

GTmetrix is a great site for getting performance metrics on the WordPress installation.

Database access

Cloudron does not support PHPMyAdmin. It is, however, possible to access the database using other methods:

  • Open a Web terminal and press the 'MySQL' button to get console access. You can execute SQL commands directly.

  • Use a plugin like WP phpMyAdmin

WP CLI

WP CLI is a command line interface to WordPress. To run commands using the CLI tool, open a Web terminal and execute commands WP CLI. For example,

wp user list

If one or more plugins/themes are erroring, you can make WP CLI skip loading plugins/themes as follows:

wp --skip-plugins --skip-themes

Additional php settings can be configured, when running the cli with php -d key=value:

sudo -E -u www-data php -d max_execution_time=100 /app/pkg/wp

In this case setting the maximum execution timeout to 100 seconds.

Disable themes

To list the themes:

sudo -E -u www-data /app/pkg/wp --skip-plugins --skip-themes theme list

To disable a theme, just activate another theme:

sudo -E -u www-data /app/pkg/wp --skip-plugins --skip-themes theme activate sometheme

PHP settings

You can add custom PHP settings in /app/data/htaccess using the File manager. Note that settings with a mode of PHP_INI_SYSTEM cannot be set in htaccess files.

For example:

#example
php_value post_max_size 600M
php_value upload_max_filesize 600M
php_value memory_limit 128M
php_value max_execution_time 300
php_value max_input_time 300
php_value session.gc_maxlifetime 1200

Migrating existing site

See our blog on how to migrate an existing WordPress site to Cloudron.

File editing

For security reasons, WordPress' built-in file editing functionality is disabled by default. You can enable this back by editing /app/data/wp-config.php and setting DISALLOW_FILE_EDIT to false.

define('DISALLOW_FILE_EDIT', false);

Unfiltered HTML

For security reasons, non-admins are not allowed to post unfiltered HTML content. You can enable this back by editing /app/data/wp-config.php and setting DISALLOW_UNFILTERED_HTML to false.

define('DISALLOW_UNFILTERED_HTML', false);