In addition to the admin dashboard, Flarum provides several console commands to help manage your forum over the terminal.
To use the console:
sshinto the server where your flarum installation is hosted
cdto the folder that contains a file called
- Run the command via
php flarum [command]
Lists all available management commands, as well as instructions for using management commands
php flarum help [command_name]
Displays help output for a given command.
You can also output the help in other formats by using the --format option:
php flarum help --format=xml list
To display the list of available commands, please use the list command.
php flarum info
Gather information about Flarum's core and installed extensions. This is very useful for debugging issues, and should be shared when requesting support.
php flarum cache:clear
Clears the backend flarum cache, including generated js/css, text formatter cache, and cached translations. This should be run after installing or removing extensions, and running this should be the first step when issues occur.
php flarum assets:publish
Publish assets from core and extensions (e.g. compiled JS/CSS, bootstrap icons, logos, etc). This is useful if your assets have become corrupted, or if you have switched filesystem drivers for the
php flarum migrate
Runs all outstanding migrations. This should be used when an extension that modifies the database is added or updated.
php flarum migrate:reset --extension [extension_id]
Reset all migrations for an extension. This is mostly used by extension developers, but on occasion, you might need to run this if you are removing an extension, and want to clear all of its data from the database. Please note that the extension in question must currently be installed (but not necessarily enabled) for this to work.
php flarum schedule:run
Many extensions use scheduled jobs to run tasks on a regular interval. This could include database cleanups, posting scheduled drafts, generating sitemaps, etc. If any of your extensions use scheduled jobs, you should add a cron job to run this command on a regular interval:
* * * * * cd /path-to-your-flarum-install && php flarum schedule:run >> /dev/null 2>&1
This command should generally not be run manually.
Note that some hosts do not allow you to edit cron configuration directly. In this case, you should consult your host for more information on how to schedule cron jobs.
php flarum schedule:list
This command returns a list of scheduled commands (see
schedule:run for more information). This is useful for confirming that commands provided by your extensions are registered properly. This can not check that cron jobs have been scheduled successfully, or are being run.