Skip to content

Commit d8a5552

Browse files
committed
Add some troubleshooting steps.
1 parent 06aa63c commit d8a5552

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

README.md

+12
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,18 @@ $this->addPlugin('DebugKit');
3434
```
3535
* Set `'debug' => true,` in `config/app.php`.
3636

37+
## Is DebugKit not working?
38+
39+
If you don't see a CakePHP icon on the bottom right of your page DebugKit is not be
40+
working correctly. Some common problems are:
41+
42+
1. Your PHP environment doesn't have SQLite installed. Check your application
43+
logs to confirm if this happening. You can either configure DebugKit to use
44+
a different database, or install the PDO SQLite 3 extension.
45+
2. Your hostname needs to be added to the `DebugKit.safeTld`. If your local
46+
domain isn't a known development environment name, DebugKit will disable
47+
itself to protect a potentially non-development environment.
48+
3749
## Reporting Issues
3850

3951
If you have a problem with DebugKit please open an issue on [GitHub](https://github.com/cakephp/debug_kit/issues).

0 commit comments

Comments
 (0)