the-djmaze/snappymail
1
1
Fork 0
mirror of https://github.com/the-djmaze/snappymail.git synced 2024-09-20 15:45:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

Updated FAQ (markdown)

the-djmaze 2022-11-02 11:43:01 +01:00
parent b7d13ad45a
commit 1ef72980c7
1 changed files with 12 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
FAQ.md

@ -1,13 +1,14 @@
# Frequently Asked Questions
The FAQ should help to find solutions to common problems.
## Admin login fails
<details><summary><h2>Admin login fails</h2></summary>
This is mostly due to the wrong login name or passphrase.
Open application.ini and modify the admin name and pass there.
Keep the passphrase setting empty and SnappyMail will create one (just like at install).
For further issues check the logs.
</details>
## How do I enable logging?
<details><summary><h2>How do I enable logging?</h2></summary>
Logs help the developer a lot to identify and fix problems. Logs are enabled in the `application.ini` file, that can be found in the directory `…/data/_data_/_default_/configs` of your SnappyMail installation. There are different types of logs:
* Server side log (PHP)
* Under [logs], set `enable = On`.
@ -16,14 +17,16 @@ Logs help the developer a lot to identify and fix problems. Logs are enabled in
* Client side log (Javascript)
* Under [labs], set `use_app_debug_js = On`.
* Click F12 to open the console in your browser and get the log from there.
</details>
## When I click on 'Display external images', while reading an email, nothing happens. What's wrong?
<details><summary><h2>When I click on 'Display external images', nothing happens.</h2></summary>
This is a security feature. You can enable it the following way:
* Login to the admin UI.
* Go to settings.
* Enable 'Use local proxy for external images'.
</details>
## Enable Filters
<details><summary><h2>Enable Filters</h2></summary>
SnappyMail requires Sieve for managing filters.
Sieve must be installed on the IMAP server and integrated in the IMAP daemon.
Currently there is no other way to manage filters.
@ -31,15 +34,18 @@ When the IMAP supports Sieve, you can enable this in the Admin Panel of SnappyMa
There you have to check "Allow sieve scripts" and enter the data of your server (normally your IMAP server).
After enabling filters in the Admin Panel the users can enter in their settings and should see a new menu "Filters" where for example an vacation message can be activated.
</details>
## [105] Missing snappymail/v/x.x.x/include.php
<details><summary><h2>[105] Missing snappymail/v/x.x.x/include.php</h2></summary>
When you upgrade, a lot of files are replaced.
If `/snappymail/v/x.x.x/` exists, open `/index.php` and check the value of `APP_VERSION`.
When they are the same, your PHP OPcache does not reload the files and has the old file in cache and uses that.
Reload your PHP-FPM or FastCGI to get this solved.
</details>
## Nextcloud "App with id snappymail has invalid signature"
<details><summary><h2>Nextcloud "App with id snappymail has invalid signature"</h2></summary>
Sometimes i upload a new version of the release due to my own stupid "built release" mistakes.
But apps.nextcloud.com doesn't allow me to do anything (remove, revoke, special version numbers, etc.).
So the result is that i can only overwrite an existing release and wait a few hours.
Then Nextcloud updates to the signature and invalid becomes valid.
</details>