Support Topics: Email: How To: Setup Squirrelmail on your site
What you would use this for: To provide yourself or people using POP email addresses at your domain access to webmail via your website.
What you need:
An FTP client (Transmit - external link)
A text editor (TextWrangler - external link)
1. Go to http://www.squirrelmail.org (external link) and download a copy of the SquirrelMail installation package. The file will download as squirrelmail followed by a version number and ending with a .tar.gz extension. We'll refer to this as the squirrelmail.tar.gz file.
2. If the installation package doesn't expand automatically, double click the squirrelmail.tar.gz file. This should force the compressed squirrelmail.tar.gz to expand into a folder that begins with the "squirrelmail", followed by a version number. We'll refer to this folder the SquirrelMail folder from now on.
3. Login to your FTP space on the MacHighway server and create a folder outside of your public_html folder. This folder will store the data files for SquirrelMail. In our example we'll be naming the folder "smdata". In this example we'll be using Transmit as our FTP application. In Transmit make sure you are outside of your public_html folder and click the "New Folder" button in the upper left hand corner. Create the folder on "their stuff" (meaning on the server) and call the folder "smdata" (without the quotes).
4. Upload the contents of the "data" folder within the SquirrelMail folder on your harddrive to the folder "smdata" that we just created.
5. Set the permissions on the "smdata" folder to 777. To do this using Transmit, highlight the folder and press command + i. In the window that pops up, you can either type 777 into the bottom field or make sure all boxes are checked.
6. Back to the SquirrelMail folder on your computer, open the file config_default.php in the "config" folder using TextWrangler (control-click on the file and choose to open with TextWrangler). Search for the line $domain = 'example.com'; by pressing command + f and searching for: $domain = 'example.com';
7. Change this line to read: $domain = 'YourWebSite.com'; (where YourWebSite.com is your website address)
8. Search for the line: $smtpServerAddress = 'localhost';
Change this line to read: $smtpServerAddress = 'mail.machighway.com';
9. Search for the line: $imapServerAddress = 'localhost';
Change this line to read: $imapServerAddress = 'mail.machighway.com';
10. Search for the line: $data_dir = SM_PATH . 'data/';
There are two lines that contain this information. We want to change the second line (the line without the * before it).
Change this line to read: $data_dir = '/Library/WebServer/WebSites/YourUsername/smdata'; (replace YourUsername with your MacHighway username)
11. Search for the line: $attachment_dir = '/var/local/squirrelmail/attach/';
Change this line to read: $attachment_dir = SM_PATH . 'attach/';
12. Search for the line: $smtp_auth_mech = 'none';
Change this line to read: $smtp_auth_mech = 'login';
13. Save this file and name it "config.php" (without the quotes) by selecting "Save As" from the File directroy in TextWrangler.
14. Login to your FTP space on the MacHighway server and create a folder inside of your public_html folder called "squirrelmail" (without the quotes). Upload the entire contents of the SquirrelMail folder (except for the data folder) on your computer into the squirrelmail folder on the server.
15. Create a folder called "attach" (without the quotes) inside of the "squirrelmail" folder on the server. Set the permissions on this folder to 733 by hilighting the folder and pressing command + i. In the dialog box that pops up you can either check all of the boxes on the top row and the last two boxes on rows 2 and 3, or simply type 733 in the box below the checkboxes. This will be used as a temporary folder for uploading attachments.
16. Open your web browser and point it to: http://www.YourWebSite.com/squirrelmail/src/configtest.php
17. A message at the bottom of the screen should read "Congratulations, your SquirrelMail setup looks fine to me!". Click "Login now" and you can now begin using SquirrelMail.
For further support, review the included documentation in the SquirrelMail folder or visit their support site here. (external link
|
