User Tools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
services:snappymail [2025/04/15 15:57] – willyservices:snappymail [2025/04/15 16:22] (current) – willy
Line 2: Line 2:
  
 [[https://github.com/the-djmaze/snappymail|Snappy Mail]] is a simple, modern, lightweight & fast web-based email client. It is the successor of the long defunct RainLoop webmail client. [[https://github.com/the-djmaze/snappymail|Snappy Mail]] is a simple, modern, lightweight & fast web-based email client. It is the successor of the long defunct RainLoop webmail client.
 +
 +**Note:** i installed SnappyMail on my //external// server, together with the mail server, and not on the home server. The unusual approach you might note here are due to that noticeable differences.
  
 ===== Installation ===== ===== Installation =====
Line 7: Line 9:
 Get your release [[https://github.com/the-djmaze/snappymail/releases|here]] Get your release [[https://github.com/the-djmaze/snappymail/releases|here]]
  
-will install under /home/web/snappymail:+will install under /home/web/snappymail. Replace, in the following instruction, the URL and filename with the latest release:
 <code bash> <code bash>
-cd /home/web +mkdir -p /home/web/snappymail/frontend 
-mkdir snappymail +cd /home/web/snappymail/frontend
-cd snappymail+
 wget https://github.com/the-djmaze/snappymail/releases/download/v2.38.2/snappymail-2.38.2.tar.gz wget https://github.com/the-djmaze/snappymail/releases/download/v2.38.2/snappymail-2.38.2.tar.gz
 tar xvf snappymail-2.38.2.tar.gz  tar xvf snappymail-2.38.2.tar.gz 
 find ./  -type d -exec chmod 755 {} \; find ./  -type d -exec chmod 755 {} \;
 find ./ -type f -exec chmod 644 {} \; find ./ -type f -exec chmod 644 {} \;
-chown web:web .+chown -R web:web data
 </code> </code>
 +
 +==== Secure the data folder ====
 +
 +Move the data folder //outside// the document root can be a good idea. First of all, move it physically:
 +<code bash>
 +cd /home/web/snappymail
 +mv frontend/data .
 +mv frontend/_include.php frontend/include.php
 +</code>
 +
 +Now edit the file **frontend/include.php** and add setup the following line:
 +<code>
 +define('APP_DATA_FOLDER_PATH', '/home/web/snappymail/data/');
 +</code>
 +
 +The trailing "/" is **very** important.
 +
  
 ===== Reverse Proxy ===== ===== Reverse Proxy =====
Line 28: Line 46:
         index index.php;         index index.php;
  
-        root /home/web/snappymail;+        root /home/web/snappymail/frontend;
  
         access_log /var/log/nginx/webmail.mydomain.com_access_log main;         access_log /var/log/nginx/webmail.mydomain.com_access_log main;
Line 73: Line 91:
 You need to setup the domains you want to use in SnappyMail to allow users to login. You need to setup the domains you want to use in SnappyMail to allow users to login.
  
 +===== Upgrade =====
 +
 +To upgrade the installation, you simply need to upload files from the new package overwriting existing files. Directory structure is organized to have each new version installed to a different directory. Only a few files will be actually overwritten (/index.php and /data/VERSION).
  
 +All the additional reconfiguration will be done by the product on next run.
  
 +Then when everything works, you may remove any old version that resides in /snappymail/v/.