[Nutsmail Support Center] Most Popular Articles

Installation instructions - Generic - server-wide

Mon, 06 Dec 2010 11:18:25 GMT

From NutsMail 3.8 and up

1. Upload all NutsMail files to /usr/share/nutsmail
2. Upload skin files
3. Change the nutsmail folder permissions to 755 chmod -R 755 nutsmail
4. Navigate to the NutsMail install (if you get redirected to /src/login.php please delete that and go back to /nutsmail/) and go through the setup.
5. If you want to point your webmail.domain.com to the nutsmail folder you will need to edit your httpd.conf file found in /ect/httpd/conf/
Change to:
Alias /webmail /usr/share/nutsmail
6. Restart your httpd server
From NutsMail 3.7 and down:

Click here to download a PDF

After installing Nutsmail, I get a blank page in my browser

Mon, 06 Dec 2010 10:52:01 GMT

It's most likely a permissions problem. If you're installing serverwide then check your permissions. Your permissions need to be set to 755 for the nutsmail folder.

What's the difference between a Skin, Theme and a Package?

Thu, 10 Dec 2009 03:17:45 GMT

A Skin is just one look for squirrelmail, for example W2:Iceblue is a "skin" A Theme is a set of skins, for example: Outlook XP Theme is a theme containing 4 skins A Package is the archive you download, we provide several packages, the "base" package is a customized version of squirrelmail that you need to use for our skins to work. A skin package will either contain a single skin, or a theme. A plugin package will contain a customized version of a plugin, designed to integrate into our skins.

WARNING! Tell your admin to set the SpamFilters_YourHop variable.

Tue, 24 Nov 2009 10:27:42 GMT

I get the following error-message when trying to setup spam filters:

WARNING! Tell your admin to set the SpamFilters_YourHop variable.

Solution:

Set this to a string containing something unique to the line in the header you want me to find IPs to scan the databases with. For example, All the email coming IN from the internet to my site has a line in the header that looks like (all on one line):

Received: [from usw-sf-list1.sourceforge.net (usw-sf-fw2.sourceforge.net     [216.136.171.252]) by firewall.persistence.com (SYSADMIN-antispam      0.2) with

Since this line indicates the FIRST hop the email takes into my network, I set my SpamFilters_YourHop to 'by firewall.persistence.com' but any case-sensitive string will do. You can set it to something found on every line in the header (like ' ') if you want to scan all IPs in the header (lots of false alarms here tho).

global $SpamFilters_YourHop;

$SpamFilters_YourHop = ' ';

Example

Received: from sitemeter.com (mail.sitemeter.com [69.44.157.220])     by mail.mailserver.com (Postfix) with ESMTP id 487A61F6151     for ; Mon, 6 Dec 2004 08:53:21 +0000 (GMT)Received: from SM50442 ([66.132.236.185])     by sitemeter.com (sitemeter.com [69.44.157.220])     (MDaemon.PRO.v7.2.0.R)     with ESMTP id md50016287249.msg     for ; Mon, 06 Dec 2004 03:49:26 -0500

In the above address header, my real mail server is "mail.mailserver.com" and hence I would set:

$SpamFilters_YourHop = 'by mail.mailserver.com';

I've purchased your skin in the past and would like to re-download the files

Mon, 06 Dec 2010 10:25:51 GMT

After one year your downloads expire. If you would like to renew it you can do so through the members area. In the members area navigate to: My Packages->Downloads->License renewal button

I've enabled the quota plugin, but it doesn't work in Internet Explorer

Thu, 12 Nov 2009 08:34:43 GMT

Due to IE's rendering we have to "hide" the quota container by default.

To show the plugin:

go to the /themes/css/ folder of your installation
look for and download any .css files that have _ie or _ie7 in their filename
edit the file and remove these lines
```
#quota_div {
display: none;
}
```
save the files and upload them back to your server

Installation instructions - cPanel - server-wide

Wed, 01 Feb 2012 17:25:22 GMT

1. Upload the NutsMail base files to /usr/local/cpanel/base/3rdparty/nutsmail
2. Upload the skin files
3. Change the entire nutsmail folder permissions to 755 chmod -R 755 nutsmail
4. Change the data and attach folder permissions to 777
5. Place the yaml file (found in the Public Downloads members area) into /var/cpanel/webmail/webmail_mywebmailapp.yaml.
6. Navigate to your cPanel's webmail login page and go through the setup options. p.s. To avoid cPanel automatically logging into your webmail after logging off make sure this variable is set in the config.php $signout_page = '/webmaillogout.cgi';

I can't find the shared calendar plugin

Mon, 08 Aug 2011 08:25:39 GMT

We provide a modified version of the Shared Calendars plugin that will work with Nutsmail. The shared calendar is available for Enterprise and Unlimited customers in their members download area.

I'd like to use an old skin i purchased from you with a new skin, is this possible?

Mon, 06 Dec 2010 10:17:07 GMT

From NutsMail 3.8 and up to add any old skins simply copy the themes and skin folder into your NutsMail installation and it will automatically find the old skin files and they should show up in your display settings.

"Cannot redeclare class calendar" error message

Fri, 20 Nov 2009 08:18:56 GMT

Problem:

I've installed and enabled the shared calendar plugin but when i go to my setup to test it, I get this error message:

Fatal error: Cannot redeclare class calendar in .../calendar.php on line ...

This is caused by the smallcal plugin, Shared Calendars has it's own version of the small calendar that shows up in the left pane

Solution:

Disable the smallcal plugin in config/config_local.php

Calendar on the left isn't showing

Fri, 20 Nov 2009 06:30:24 GMT

By default the calendar is not set to be visible, to enable it, do the following: Go to options >> display preferences Scroll down to: Small Calendar Options And check the box next to: Small Calendar: show small calendar in left bar If you would like this to be turned on by default, you will need to edit the default_pref file stored in your data folder. If you've moved this folder make sure you're editing the file in the folder that matches your $data_dir setting in your config_local.php file. Once you've located the file, edit it and add the following on a new line: smallcal_show = 1

NutsMail installation instructions for Mac OSX snow leopard servers

Mon, 06 Dec 2010 11:34:46 GMT

From NutsMail 3.8 and up: OS X Server Installation: 1. Upload all base files to /usr/share/nutsmail 2. Upload all skin files to the same place /usr/share/nutsmail 3. Copy file httpd_squirrelmail.conf (found in the Public Downloads members area) to /etc/apache2 4. Restart web server 5. point your browser to http://servername/webmail 6. In the setup change config options for Mac OS X Snow Leopard $imap_auth_mech = 'cram-md5'; $imap_server_type = 'cyrus'; 7. All done, it should now work by pointing your browser to http://servername/webmail For NutsMail 3.7 and down: Attached are generic configuration files to allow Nutsmail to work with Snow Leopard 10.6.4. This assumes that Nutsmail has been installed in /usr/share/nutsmail and that /usr/share/squirrelmail is retained. (Files available upon request) -- With these files the installation process is... -- -- Run Cyberduck on a remote mac -- Attach to Snow Leopard server with an SFTP session username root, password as required -- Use the folder drop down box to go to / -- Click on /usr folder -- Click on /usr/share folder -- While share folder is selected, right click, create folder, 'nutsmail' -- Click on /usr/share/nutsmail folder -- Select action, upload -- Upload the base package to the /usr/share/nutsmail folder -- Select action, upload -- Upload the skin package to the /usr/share/nutsmail folder -- Click on base package with the /usr/share/nutsmail folder -- Right click, Expand Archive -- Click on skin package within the /usr/share/nutsmail folder -- Right click, Expand Archive -- -- The packages will now have been unpacked on the server and new subdirectories within nutsmail will be visible. -- -- Click on usr/share/nutsmail/config folder -- Click on config.php -- Rick click, duplicate file (this creates a backup of your original file) -- Click on config_local.php -- Rick click, duplicate file (this creates a backup of your original file) -- Click on usr/share/nutsmail/config folder -- Select action, upload -- Upload config.php included with this email into /usr/share/nutsmail folder, accept replace -- Upload config_local.php included with this email into /usr/share/nutsmail folder, accept replace -- -- Click on /etc folder -- Click on /etc/apache2 folder -- Click on httpd_squirrelmail.conf -- Rick click, duplicate file (this creates a backup of your original file) -- Click on /etc/apache2 folder -- Select action, upload -- Upload httpd_squirrelmail.conf included with this email into /etc/apache2 folder, accept replace -- -- Run the Snow Leopard server administration tool against your server -- Stop Web -- Start Web -- -- Using your browser connect to http://servername/webmail -- -- You should now see the nutsmail login. p.s. A special thanks to Tony Krzyzewski from kaon.co.nz for putting this together.

Installation instructions - FTP - Single Domain

Mon, 06 Dec 2010 11:17:59 GMT

From NutsMail 3.8 and up:

1. Create a NutsMail folder and upload all files including the skin files.
2. Navigate to the installation, http://yourdomain.com/nutsmail
3. Follow the setup options and it should work.

From NutsMail 3.7 and down:

Click here to download a PDF

What's the difference between a skin and a theme?

Mon, 08 Mar 2010 10:18:02 GMT

W2:IceBlue or XP:Summer etc... are each a single "skin", a "theme" would be the full set of skins, ie "W2" or "XP" etc...

I just purchased a skin but the download link isn't working

Mon, 08 Mar 2010 10:29:15 GMT

We get a lot of fraudulent orders, because of this we manually check the payment as it comes in. Once it clears (24hr max waiting time but usually it's within minutes) we will activate your account. We're sorry for any inconvenience this may cause you.

SquirrelMail and Smtp TLS

Mon, 12 Jul 2010 10:28:03 GMT

In the event that you make use of TLS for SMTP, due to them not operating together well, you need to have squirrelmail running on the same box as your mail server to get around this and not have the security concerns.

Changing the window title "YourDomain.com" to show the login domain instead

Mon, 06 Dec 2010 10:32:02 GMT

In a multi-domain environment you may want to have the domain name being used to login show on the title bar. To achieve this either: 1. Go into the config/config.php with a text editor and change $org_name and $org_title in the config_local.php to use preg_replace("/^www\./i","",$_SERVER['SERVER_NAME']); or 2. You can use the admin panel in the options->NutsMail Configuration and add preg_replace("/^www\./i","",$_SERVER['SERVER_NAME']); to the $org_name box. (You will only see the NutsMail config panel if you are logged in as the administrator.)

suPHP permissions error for NutsMail installs

Fri, 10 Sep 2010 11:40:33 GMT

To turn off suPHP for the NutsMail directory add this code below: suPHP_Engine off in the apache conf file httpd.conf or apache2.conf Of course change the /path/to/nutsmail/setup to the actual NutsMail install path.

Error opening or finding ../data/default_pref

Mon, 06 Dec 2010 10:36:03 GMT

If you are getting a default_pref file error there are a few things to check for: 1. If the error message is about finding the file then your config/config.php settings aren't pointing to the correct /data/ folder path. Check the $data_dir path is correct. 2. If you are getting an access error "Cannot access, write or open file", most likely your permissions aren't set correctly on the /data/ folder. Check the permissions and try again. (Detailed permission settings for single domain and serverwide installs can be found in our install PDF downloads.)

secure login plugin fails

Sat, 03 Jul 2010 09:47:11 GMT

In the event of issues with the secure login plugin - be sure the following value is set in functions/global.php: // Allow login_secure switch from https to http $only_secure_cookies = false; This should resolve your issue with the secure login plugin/module.

Installing the shared calendar plugin

Mon, 06 Dec 2010 11:04:51 GMT

The shared calendar plugin replaces the default calendar plugin so there are a few steps to make sure there are no conflicts. (If you're running under the admin email address you can access all the config options through options->NutsMail Configuration Backup your default calendar folder Upload all the shared calendar files into a folder called calendar Disable the small_cal plugin as shared calendar comes with it's own small_cal. Enable a file system plugin calendar_file_backend Reload and it should work.

Changing the default login screen (Enterprise package)

Thu, 20 Jan 2011 12:01:25 GMT

As we purchase the full pack and we have i:theme as first screen at login, I would like to change that to web2.0 login screen, can you suggest the better way to do this. If you go into options->Configure NutsMail->Default desktop theme you can set what login theme to use. If you don't see the "Configure NutsMail" in options then please add your email address to the admin in config/config.php file and try again.

Upgrading to NutsMail 3.8

Mon, 06 Dec 2010 11:44:18 GMT

Using the upgrade package: 1. Backup your data and attach folder. 2. Upload and replace all files. 3. Change permissions to full install folder to chmod 755 4. Change permissions of the config folder and all files inside to 777 5. Navigate to the install and it automatically sets you up with the latest config options. 6. Edit config/config.php $config_admin_account = "admin_email@yoursite.com"; to access the configuration through NutsMail when the admin is logged in.

cPanel install. The server was not able to find the document (./3rdparty/nutsmail) you requested.

Mon, 06 Dec 2010 10:54:11 GMT

Make sure you have a slash at the end of your path http://domain.com/3rdparty/nutsmail/

First time loading in cPanel it says Access denied

Mon, 06 Dec 2010 10:52:46 GMT

Your permissions aren't setup correctly. chmod -R 755 install directory.