# Troubleshooting Guide -

**URL:** <https://forum.mautic.org/t/troubleshooting-guide/21093>\
**Category:** Site Feedback\
**Created:** [September 30, 2021, 7:44pm UTC](https://forum.mautic.org/t/troubleshooting-guide/21093 "2021-09-30T19:44:07Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![EJL](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/ejl/32/12155_2.png) [@EJL](https://forum.mautic.org/u/EJL)\
**Post date:** [September 30, 2021, 7:44pm UTC](https://forum.mautic.org/t/troubleshooting-guide/21093/1 "2021-09-30T19:44:07Z")

</div>

@joeyk @ekke @silavapi

_Feel free to move/remove if this is not appropriate._

I wonder if we could aggregate some troubleshooting steps and sticky to the top of the support thread? Searching the forum for issues that are identical to what you may be facing is often met with some variables that make the process a bit more tedious than it has to be. I think we can improve the effectiveness of the forum, and increase the satisfaction of Mautic users as well. Lots of us spend time trying to answer the posts but I think we can all agree a high percentage are lack of searching and/or repetitive.

Ill go first:

-Step One: Clear Cache via CLI using **cache:clear**

-Step Two: Ensure permissions are properly set (thanks @mikew for this ----\> )  
**chown -u www-data:www-data** (on the whole Mautic directory)

-Step Three: Verify php.ini has appropriate maximums set for memory, execution time, and that a time zone is set.

-Step Four: open mautic/app/config/local.php and turn debugging on (line 120 in local.php)  
`'debug' => true,`

-Step Five: set db driver to pdo\_mysql by editing line 3 of local.php like so `'db_driver' => 'pdo_mysql'`

-Step Six run php -v to ensure proper PHP version. On most servers there are 2 versions of PHP and CLI PHP

@joeyk has covered cron jobs extensively ( Insert link to Joey’s great work here)

**Campaign emails not sending?** - run **mautic:segments:update --list-id#** \<–enter segment that corresponds to segment of campaign  
Then run **mautic:campaigns:update -f -vvv** to sync segment members to campaign actions  
Then run **mautic:campaigns:trigger -f -vvv** to run campaigns

If you are using queue then run **swiftmailer:spool:send**

-Segment Emails not sending?  
Ensure a publish date is set then run **mautic:broadcasts:send --channel=email –id=#**  
if you are using queue then run **swiftmailer:spool:send**

-Texts not sending?  
**mautic:campaigns:messages --channel=sms**  
or  
**mautic:messages:send [options]  
mautic:campaigns:messagequeue  
mautic:campaigns:messages**

Options:  
-c, --channel[=CHANNEL] Channel to use for sending messages i.e. email, sms.  
-i, --channel-id=CHANNEL-ID The ID of the message i.e. email ID, sms ID.  
-m, --message-id=MESSAGE-ID ID of a specific queued message  
–bypass-locking Bypass locking.  
-t, --timeout=TIMEOUT If getmypid() is disabled on this system, lock files will be used. This option will assume the process is dead after the specified number of seconds and will execute anyway. This is disabled by default.  
-x, --lock\_mode=LOCK\_MODE Allowed value are “pid” or “flock”. By default, lock will try with pid, if not available will use file system [default: “pid”]  
-f, --force Deprecated; use --bypass-locking instead.  
-h, --help Display this help message  
-q, --quiet Do not output any message  
-V, --version Display this application version  
–ansi Force ANSI output  
–no-ansi Disable ANSI output  
-n, --no-interaction Do not ask any interactive question  
-e, --env=ENV The Environment name. [default: “prod”]  
–no-debug Switches off debug mode.  
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

-Database Issues (BACKUP YOUR DATABASE FIRST)  
Run the **doctrine:schema:update --force** then clear your cache using **cache:clear**

Tip: Open browser -Right click - Inspect page. Leave those open while you test. Look for errors.

-Will Update More Later-

Please post your suggestions and comments.

---

<div class="post-metadata">

**Author:** ![silavapi](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/silavapi/32/7424_2.png) [@silavapi](https://forum.mautic.org/u/silavapi)\
**Post date:** [September 30, 2021, 7:53pm UTC](https://forum.mautic.org/t/troubleshooting-guide/21093/2 "2021-09-30T19:53:43Z")

</div>

Hey there!

For sure, but I think that this would be a better place to collate them and link to it:

> **[Troubleshooting](https://docs.mautic.org/en/troubleshooting)**
>
> . Follow these steps to solve your issue as fast as possible.My Mautic is acting weird. Even through the effort of the dev and test teams, it might happen. At first, let's try a few tricks which might fix it fast.1. Clear the cache. There are several...

The page could definitely do with an overhaul if you’d like to take it on!

We also have other pages for example:

> **[Cron jobs](https://docs.mautic.org/en/setup/cron-jobs)**
>
> . . . . Mautic 3 introduced a new path for cron jobs bin/console if you are using the legacy Mautic 2.x series you should replace this with the older version, app/console. . . . Mautic requires a few cron jobs to handle some maintenance tasks such as...

which we could perhaps include in a pinned post on the support category?

I’ve also been working on a PR to improve / organise the install/upgrade docs which would value a review so we can get it merged:

> <https://github.com/mautic/mautic-documentation/pull/229>
>
> Fixes #197 
> 
> Our documentation for installing and upgrading Mautic is pretty p…oor, and scattered across several places.
> 
> This is a first attempt at bringing things under one central location in the end-user documentation.
> 
> \## Plan of attack
> 
> \- \[x\] Add a 'How to install Mautic' and 'How to update Mautic' section in the Setup section
> \- \[x\] Move the Maxmind information into a 'Getting started with Mautic' section (as it's rarely configured at install)
> \- \[x\] Write documentation on how to install from the production package
> - \[x\] In the UI - need to add screenshots
> - \[x\] At the command line
> \- \[x\] Write documentation on how to install locally by cloning from Github
> \- \[x\] Write documentation on how to install using Composer
> - \[x\] Regular install process
> - \[x\] Using the recommended project
> - \[x\] Configuring the recommended project / scaffold
> \- \[x\] Write documentation on how to upgrade Mautic 
> - \[x\] In the browser
> - \[x\] At the command line
> \- \[x\] Improve the documentation relating to failed updates and how to resolve them
> \- \[x\] Improve documentation on migrations - what they are, when to run them, how and why to check for schema updates

Also pinging the Education Team Lead @favour for your input 🙂