SWCP Support Wiki - User contributions [en]

Configure K-9 on Android for SWCP Email

2026-02-04T19:52:05Z

Cheeks:

There are several email programs available for Android phones and tablets. K-9 is one that we find works well and is easy to set up.

==Get K-9==
Download the app from the Google app store. It is free.

==Configure K-9==
* Start K-9, click "Next" on the Welcome screen to start the account creation wizard.
* On the first setup screen:
** Enter your email address and password.
** Then click "Manual Setup" (do NOT click "Next").
* On the "Account Type" screen, tap "IMAP"
* On the "Incoming server settings screen":
** The username field may be pre-filled with your email address. Change this to your SWCP account name.
** The password should already be filled in.
** Set the IMAP server to: '''mail.swcp.com'''
** Set Security to '''SSL/TLS (always)'''
** Set Authentication to '''PLAIN'''
** Set Port to: '''993'''
** Leave the other settings as-is and tap "Next"
* K-9 will test the connection to the server. Assuming that works, move on to "Outgoing server settings":
** Set SMTP server to: '''mail.swcp.com'''
** Set Security to '''SSL/TLS (always)'''
** Set Port to: '''465'''
** Set Require sign-in to: '''ON (checked)'''
** Set Authentication to: '''AUTOMATIC'''
** The username and password should be auto-filled for you.
** Click "Next" to complete the outgoing server test.
* Now you are on the "Account options" page:
** You can set these items to suit you. Enabling push mail might use a lot of battery, so if you find that y our battery is suddenly draining too quickly, try turning off Push mail.
** Click "Next" to finish up
* On the last setup screen, you give the account a name to identify it. Something like "SWCP mail" makes sense to you. If you set up multiple email accounts in K-9, this is how you will tell them apart.

==About Folders==
There's an issue with how K-9 mail (and Thunderbird) on Android deal with folders. It defaults to the setting "Automatic (None)" for special folders like Sent/Drafts/Spam etc. This leaves them unmapped, which will cause the email app to fail when it tries to send a message because it doesn't know where to save the "Sent" message. To fix this, go to Settings enter the "Folders" section and manually set the correct folders (map Sent to "Sent", Drafts to "Drafts", Spam to "spamfile").

All Done! If you have any problems please contact the help desk at help@swcp.com

==See Also==
* [[Configure iPhone or iPad for SWCP Email]]
[[Category: Email]]

Vendor Partners AUP

2026-01-15T18:34:56Z

Cheeks:

SWCP has a number of vendor partners. The following are links to Acceptable Use Policies from those vendor partners.

* Qwest/CenturyLink Acceptable Use Policy- http://www.qwest.com/legal/usagePolicy.html
* Qwest/CenturyLink Privacy Policy - http://www.centurylink.com/aboutus/legal/privacypolicy.html
* Qwest/CenturyLink Supscriber Agreement - http://qwest.centurylink.com/legal/highspeedinternetsubscriberagreement/files/HSI_Subscriber_Agreement_ENG_v34_080811.pdf
(This includes several things that are not relevant to a LightSpeed connection, such as Qwest web hosting terms and conditions. The most useful section is "7. Service Conditions", which spells out some of the limits on use, such as not running servers on a residential connection).
* Domain Name Registration Agreement with our domain partner, OpenSRS - https://www.swcp.com/opensrs-agreement.html

SWCP Policies

2026-01-15T18:33:56Z

Cheeks: /* Account Policies */

==Account Policies==

[[SWCP Policy Statement]]

[[Who can modify your account?]]

[[Billing Policies|Dial-up Access Billing Policies]]

[[Privacy Policy]]

[[Vendor_Partners_AUPs|Vendor Partners' Acceptable Use Policies]]

==Email Policies==

[[Spam policy]]

[[Mailblock|Your mail has been blocked -- why?]]

==Legalese==

[[SWCP Customer Contract]]

SWCP Policies

2026-01-15T18:32:40Z

Cheeks: /* Account Policies */

==Account Policies==

[[SWCP Policy Statement]]

[[Who can modify your account?]]

[[Billing Policies|Dial-up Access Billing Policies]]

[[Privacy Policy]]

[[Vendor_Partner_AUPs|Vendor Partners' Acceptable Use Policies]]

==Email Policies==

[[Spam policy]]

[[Mailblock|Your mail has been blocked -- why?]]

==Legalese==

[[SWCP Customer Contract]]

Getting Started With Nextcloud

2025-01-28T17:59:11Z

Cheeks: Created page with "__NOTOC__ ==First things first== You should have received an admin username and password to manage your Nextcloud instance. You will use the admin login to change the configurat..."

__NOTOC__
==First things first==
You should have received an admin username and password to manage your Nextcloud instance. You will use the admin login to change the configuration of your Nextcloud, install apps, and manage users.

The first thing you should do is create a non-admin user for yourself. To do this, log in with the admin credentials, and you should see a circle with an A in it in the upper right of the screen. That is a pull-down menu with useful things on it, including "Users".

Select Users then the New user button in the upper left. Enter a username, display name, password, and their email address. Then click the Add button at the bottom. Now that user can log in.

==Adding Apps==
The initial setup includes the file sharing and photos app. If you want to add others, like the calendar, here is how.

* Log in as the admin.
* Under the A menu, select Apps
* You'll see a list of apps that are already installed (if they have a "Disable" button on the right, it means they are currently enabled).
* Click Featured Apps on the left and it will show you the list of commonly used apps. The top of the list will be the ones you already have installed. Scroll down to the others.
* Many people want to do shared Calendar and Contacts. Scroll down to Calendar, click the "Download and Enable" button. Do the same for "Contacts".
* Now those apps will have little icons accross the top of the main Nextcloud screen. Don't forget to log out of admin and log in with your personal account before you start adding calendar items.
* In the app list, when you click an app name it will give you a short description of the app and what it does.
* Some other popular apps include:
** Deck (a Trello-like organization tool)
** Forms (to make questionairres and survey forms)
** File Access Control - more fine-grained controls you have multiple groups of users that need to selectively share some files with other groups but not all groups, etc. Or even more elaborate, like "only allow HR files to be accessed from computers logged in to the local network, not over the Internet"
** Maps - use maps while keeping your data private
** Tasks - shared task lists, which can also integrate with your calendar within Nextcloud and on your devices/Thunderbird/etc.
** Talk - chat, screen-sharing, video conferencing. Kind of like slack or whatsapp or discord, but running on your own server with complete privacy.

==Desktop Sync==
You can sync your Nextcloud files to a folder on your desktop. Head over to https://nextcloud.com/install/ and click the "Download for Desktop" link and select the version for your computer type (i.e. Windows or MacOS).

When you run the installer it will prompt you to log in to Nextcloud through your browser. You'll be asked to grant permission for that app to access your Nextcloud files. After that you may be prompted to select what files to sync or not.

On Windows, there is an option for Virtual File updates. This will show you all the files but not transfer them to your computer until you access them. The alternative is a full sync, in which you will have full copies of all the files at all times. Which of these is best for you depends on whether having all the files as quickly as possible is important, at the expense of more bandwidth transferring files you may never open. If you need to access the files while offline (on a plane or desert island) you want to do full sync.

After setup, there will be a Nextcloud folder in the user directory on your computer which has the files mirrored from your Nextcloud server.

==Getting Help==
* The full Nextcloud documentation is here: https://docs.nextcloud.com/
* Feel free to contact help@swcp.com if you run into any problems or have questions about Nextcloud or how to accomplish certain things.

Install Cloudflare Turnstile CAPTCHA on WordPress

2024-10-24T23:56:51Z

Cheeks: /* Install the plugin and set up your Cloudflare account */

__NOTOC__
=Cloudflare Turnstile=
How to install the Cloudflare Turnstile CAPTCHA plugin on WordPress

==Install the plugin and set up your Cloudflare account==
''Note: if you don't already have a Cloudflare account, don't go to the default cloudflare.com to create one. If you do, it will assume you want to interact with other Cloudflare services but for this purpose you just want to access Turnstile.''

* Install the '''Simple Cloudflare Turnstile''' plugin on your WordPress site.
* Activate the plugin and then go to the link it gives: https://dash.cloudflare.com/?to=/:account/turnstile
* Create a Cloudflare account
* Click the "Create a widget" button
* For the Widget name, give a name for your site. Doesn't have to be the domain name, just a descriptive label.
* For the domain enter the domain name of your site without the "www."
* The defaults for the remaining settings are fine. Click "Create"
* You should now see Site Key and Secret Key fields.

==Configure the plugin==
* Copy the two keys from Cloudflare and paste them to the appropriate fields in the Turnstile plugin setup page on your web site.
* Select which forms you want to enable the Turnstile CAPTCHA for.
** You can select various WordPress-provided forms (like user login or post comments).
** Any form plugins that are installed should also have a pull-down menu where you can select which forms to apply the Turnstile for.
* Click Save Changes
* Do the test it displays
Now you are done! Enjoy getting less spam.
==See Also==
[[Category: WordPress]]

Install Cloudflare Turnstile CAPTCHA on WordPress

2024-10-24T23:55:58Z

Cheeks: /* Install the plugin and set up your Cloudflare account */

__NOTOC__
=Cloudflare Turnstile=
How to install the Cloudflare Turnstile CAPTCHA plugin on WordPress

==Install the plugin and set up your Cloudflare account==
''Note: if you don't already have a Cloudflare account, don't go to the default cloudflare.com to create an account. If you do, it will assume you want to interract with other Cloudflare services but for this purpose you just want to access Turnstile.''

* Install the '''Simple Cloudflare Turnstile''' plugin on your WordPress site.
* Activate the plugin and then go to the link it gives: https://dash.cloudflare.com/?to=/:account/turnstile
* Create a Cloudflare account
* Click the "Create a widget" button
* For the Widget name, give a name for your site. Doesn't have to be the domain name, just a descriptive label.
* For the domain enter the domain name of your site without the "www."
* The defaults for the remaining settings are fine. Click "Create"
* You should now see Site Key and Secret Key fields.

==Configure the plugin==
* Copy the two keys from Cloudflare and paste them to the appropriate fields in the Turnstile plugin setup page on your web site.
* Select which forms you want to enable the Turnstile CAPTCHA for.
** You can select various WordPress-provided forms (like user login or post comments).
** Any form plugins that are installed should also have a pull-down menu where you can select which forms to apply the Turnstile for.
* Click Save Changes
* Do the test it displays
Now you are done! Enjoy getting less spam.
==See Also==
[[Category: WordPress]]

Install Cloudflare Turnstile CAPTCHA on WordPress

2024-10-24T23:55:29Z

Cheeks:

__NOTOC__
=Cloudflare Turnstile=
How to install the Cloudflare Turnstile CAPTCHA plugin on WordPress

==Install the plugin and set up your Cloudflare account==
''Note: if you don't already have a Cloudflare account, don't go to the default cloudflare.com to create an account. If you do, it will assume you want to interract with other Cloudflare services but for this purpose you just want to access Turnstile.''

* Install the Simple Cloudflare Turnstile plugin on your WordPress site.
* Activate the plugin and then go to the link it gives: https://dash.cloudflare.com/?to=/:account/turnstile
* Create a Cloudflare account
* Click the "Create a widget" button
* For the Widget name, give a name for your site. Doesn't have to be the domain name, just a descriptive label.
* For the domain enter the domain name of your site without the "www."
* The defaults for the remaining settings are fine. Click "Create"
* You should now see Site Key and Secret Key fields.

==Configure the plugin==
* Copy the two keys from Cloudflare and paste them to the appropriate fields in the Turnstile plugin setup page on your web site.
* Select which forms you want to enable the Turnstile CAPTCHA for.
** You can select various WordPress-provided forms (like user login or post comments).
** Any form plugins that are installed should also have a pull-down menu where you can select which forms to apply the Turnstile for.
* Click Save Changes
* Do the test it displays
Now you are done! Enjoy getting less spam.
==See Also==
[[Category: WordPress]]

Install Cloudflare Turnstile CAPTCHA on WordPress

2024-10-24T23:53:37Z

Cheeks: Created page with "=Cloudflare Turnstile= How to install the Cloudflare Turnstile CAPTCHA plugin on WordPress ==Install the plugin and set up your Cloudflare account== 'Note: if you don't already ..."

=Cloudflare Turnstile=
How to install the Cloudflare Turnstile CAPTCHA plugin on WordPress

==Install the plugin and set up your Cloudflare account==
'Note: if you don't already have a Cloudflare account, don't go to the default cloudflare.com to create an account. If you do, it will assume you want to interract with other Cloudflare services but for this purpose you just want to access Turnstile.

* Install the Simple Cloudflare Turnstile plugin on your WordPress site.
* Activate the plugin and then go to the link it gives: https://dash.cloudflare.com/?to=/:account/turnstile
* Create a Cloudflare account
* Click the "Create a widget" button
* For the Widget name, give a name for your site. Doesn't have to be the domain name, just a descriptive label.
* For the domain enter the domain name of your site without the "www."
* The defaults for the remaining settings are fine. Click "Create"
* You should now see Site Key and Secret Key fields.

==Configure the plugin==
* Copy the two keys from Cloudflare and paste them to the appropriate fields in the Turnstile plugin setup page on your web site.
* Select which forms you want to enable the Turnstile CAPTCHA for.
** You can select various WordPress-provided forms (like user login or post comments).
** Any form plugins that are installed should also have a pull-down menu where you can select which forms to apply the Turnstile for.
* Click Save Changes
* Do the test it displays
Now you are done! Enjoy getting less spam.
==See Also==
[[Category: WordPress]]

For Web Developers

2024-10-24T23:53:17Z

Cheeks: /* Sections */

As part of SWCP's interest in Open Source software and easy to use web based applications we're working on making several open source packages easily available, see [[Webapps]] for more information about this. Many common questions are answered in the
[[KB WebApps|Web Apps]] section of our [[Knowledge Base]].

This section of the Wiki will contain more detailed information about web applications, CSS, Web brower issues,
HTML editors, and other web development issues. This is still under development, so bear with us. If you have a
topic you'd like us to cover, send email to help@swcp.com and we'll try to find you some answers.

==Sections==
[[Useful Website building Tools]]

[[Quick Recipes]] ( Short snippets of code for specific tasks )

[[Website Problems]] Things that behave badly.

[[SWCP CGI Scripts]] Scripts available for adding counters, simple forms, etc.

[[Server Side Includes]]

[[Web Hits Reports]]

[[How to use the SSL Site Verification Seal]]

[[Website Design Tools]]

Content Management Tools

[[WebApps]] - Tips and tricks for the web applications that SWCP supports (MediaWiki, WordPress, etc.)

[[Publish a Site Made With iWeb]]

[[KB FF Firebug|Firebug]] A great tool for debugging CSS issues.

How web browsing works. ( who's rendering what, when? )

[[Migration to Web Farm 2]] from SWCP Web Farm 1

[[Migration to Web Farm 2 from NMIA Web Server]]

[[Install Cloudflare Turnstile CAPTCHA on WordPress]]

RoundCube

2024-09-12T00:19:26Z

Cheeks: /* See Also */

__NOTOC__
== Welcome to RoundCube ==

RoundCube Webmail is an interface to your email system through the web. It has all the functionality you would expect from a modern email client, including MIME support, address book, folder manipulation, message searching and spell checking. Unlike other webmail clients, its user interface is very much native application-like. This means that it has features like drag-and-drop which you are probably used to from applications on your desktop.

== Login ==

Visit the RoundCube URL in your browser: http://roundcube.swcp.com The site shows the ''Login Screen''. Simply type in your email username and password.

[[Image:rc-login.jpg]] 
''This screenshot shows the RoundCube Login Screen''

== Overview ==

The next screen, after you have logged in, gives you an overview of your Inbox and mail functions.

[[Image:rc-overview.jpg]]

The screen above consists of four main parts. We will now have a closer look at each of them.

=== The folder list (1) ===

The menu at the left hand side of the screen shows all the mail folders in your email account.

You will always find the first five of those: ''Inbox'' (this is where new emails arrive, by default); Drafts (this is where your draft messages are stored, see later on composing emails); ''Sent'' (messages sent by yourself are stored there); Junk (for Spam messages) and ''Trash'' (for messages that you have deleted). The ''Trash'' folder will be emptied when you log out. In addition to the five folders just described, you might see additional folders like "Mailing Lists" and "Test in the screen shot above. Those have been created by yourself or SWCP, and can be used to organize your email into further categories.

Some of the folders are indicated in bold and carry a number in parentheses to the right of them. This indicates that these folders contain unread messages and the number tells you how many.

To open a folder, you have to click on it once. Its message list will then appear shortly after.

=== The action bar (2) ===
This part of the screen contains a number of icons that allow you to perform different actions, depending on what is being shown in the main part of the window (4). In this example, the 7 icons have the following functions, from left to right:
* ''Refresh Folder:'' checks for new messages in the current folder 
* ''Compose:'' creates a new email message 
* ''Reply:'' creates a new message in reply to the currently selected one; it will be addressed to the sender of the selected message only. 
* ''Reply to all:'' similar to Reply, but the reply will not only be addressed to the sender of the selected message but also to all of its recipients. This makes sense if the message was sent to a group of people and you want all of them to receive your answer. 
* ''Forward Message:'' forwards the currently selected message to another person 
* ''Delete:'' delete the currently selected message(s), that is, move them to Trash 
* ''Print:'' print the currently selected message 

To the right of the action bar, you can see the search field. This field allows you to search all messages in the current folder, much like a search engine on the web. Just enter your search terms and press the Return key. If you are done with your search and want to go back to the original message list, click on the little (X) symbol to the right of the search field.

=== The application bar (3) ===

The three icons at the top right of the screen give you access to different applications which are part of RoundCube. Obviously, this includes the E-Mail component that you have just been looking at. In addition to that, there is also the Address Book which we will describe later. The Personal Settings button gives you access to a number of options that allow you to customize RoundCube according to your needs. Finally, the logout button terminates your RoundCube session. You should always logout after using RoundCube to make sure that nobody else using the same computer will be able to access your emails.

=== The message list (4) ===

This part of the screen is displaying the list of all messages in the folder. To view a message, you have to double-click on it. You can also select a message by clicking on it once and then perform some action on it using one of the buttons in the action bar, e.g. Reply. You can select more than one message by holding the Ctrl key and then clicking on a number of messages in succession. To select a range of messages, select the first message, hold the Shift key and then click on the last message you want to select. Finally, you can also drag-and-drop messages to another folder. Just selected them and then drag them over to one of the folders in the folder list to the left by holding the mouse button. This also provides another way of deleting messages: just drag them into the Trash folder.

You will have noticed that some of the messages in our sample screen were indicated in bold and by a star symbol to the left of them. These are message that have not yet been read by you. A message carrying a little paper clip icon to its right contains an attachment, such as a PDF document or a photo.

== RoundCube Tips ==

=== Using search ===

When entering a search string RoundCube will search in subject and from headers only.

Specific searching is available. Just precede the word to search for with one of the following keywords: from, to, cc, subject or body. Here are a few examples finding emails with 'from' containing 'thomas' and 'subject' containing 'foo'.

from:thomas

subject:foo

=== Preview Pane ===
By default the Preview Pane displays each message as soon as you highlight it in the message list. If you prefer to double-click on the message to view it, do the following:

* In RoundCube click '''Settings'''
* Click '''Mailbox View''' on the left side of the screen
* Uncheck the box next to '''Preview Pane'''
* Click '''Save'''

=== Deleting Messages ===
By default, when you delete a message it is copied to the Trash folder instead of being deleted from the system right away. When you log out, the Trash folder is emptied. Some people run into a problem when the messages they are deleting are so large that they run out of space in the Trash folder. (The error message from RoundCube is, "Unable to move message. Over quota? Trash folder missing?") Here's one solution:
* First, select the messages you want to delete. Use Shift+Click to select a range of messages, or Control+Click to select multiple non-consecutive messages.
* Then hold down the Shift key and press your keyboard's Delete key
This process tells RoundCube to delete the messages immediately, without copying them in the Trash folder first. (It's like the old "delete and expunge" setting in TWIG).

=== Printing Messages ===
To print a message:
* Select the message you want to print from the message list (click it once to highlight it)
* Click the "gear" icon at the top, and you'll get a pull-down menu with several options.
* Select "Print this message".

=== Using the Address Book ===
There are two ways to use the address book. One way is to visit the Address Book from the main page, select a contact, then click the "Compose Mail" icon to send mail to that contact.

The other way is more commonly used. When composing a message, you can type recipient names into the Recipient or CC fields. You can type a whole email address there, or pick an address from your address book. While you type, RoundCube automatically searches for matching names in your address book and displays them. Just type a couple of letters of the person's name and RoundCube will pop up the possible matches.
Press ENTER on the one you want, or click it with the mouse, and then it will be displayed in the recipient box (or CC box if you are adding a CC).

If you don't remember any part of the name you want, type "." and it will display all of your address book entries. That works OK unless you have a very large address book.

If your address book is very large, another option is to open a new browser tab, and log it in to RoundCube and display the address book there. Then you can flip betwee the tabs to see the composition window or the address book window.

=== Folder Management ===
At the bottom of the folder list there is a "gear" icon. Click it to pull down a menu of folder options.
* Compact: If the folder has messages marked for deletion which have not been expunged, this will expunge them.
* Empty: Delete all messages from the folder.
* Manage Folders: From here you can subscribe/unsubscribe to different folders, delete folders, and create new folders.
* Download: This will download a ZIP file containing all the messages from the selected folder to your local machine.

=== Message Templates ===
Roundcube does not yet support "template messages". Here is a workaround that works pretty well though:

# Write your template message and send it to yourself.
# Right-click on the message in your inbox, select Copy To > Drafts.
# Select the message in your Drafts folder. At the top of the message body it will say, "This is a draft message" with an "Edit" link. Click Edit.
# Now customize the message (including the To/Cc list if needed) and send it.

Bonus Tip:
* If you know you will need to do this many times, you can copy the message from your inbox to Drafts several times. Now your Drafts folder will have a handful of copies of the message, and you can quickly pick one to customize and send.

=== Archiving Messages ===
* Log in to roundcube, select a folder
* Click the Gear icon in the lower left under the folder list
* Select [downloadfolder]
* Repeat for each folder you want to archive
The download is a zip file which contains each message in the folder, in .eml format. Most email clients can open .eml files directly.

==See Also==
* [[RoundCube 0.4 Features]]
* [[RoundCube Distribution List]] - How to make a distribution list
* [[Using Multiple Identities in RoundCube Mail]]
[[Category: Email]]
[[Category: Webmail]]
[[Category: RoundCube]]

RoundCube

2024-09-12T00:18:05Z

Cheeks: /* See Also */

__NOTOC__
== Welcome to RoundCube ==

RoundCube Webmail is an interface to your email system through the web. It has all the functionality you would expect from a modern email client, including MIME support, address book, folder manipulation, message searching and spell checking. Unlike other webmail clients, its user interface is very much native application-like. This means that it has features like drag-and-drop which you are probably used to from applications on your desktop.

== Login ==

Visit the RoundCube URL in your browser: http://roundcube.swcp.com The site shows the ''Login Screen''. Simply type in your email username and password.

[[Image:rc-login.jpg]] 
''This screenshot shows the RoundCube Login Screen''

== Overview ==

The next screen, after you have logged in, gives you an overview of your Inbox and mail functions.

[[Image:rc-overview.jpg]]

The screen above consists of four main parts. We will now have a closer look at each of them.

=== The folder list (1) ===

The menu at the left hand side of the screen shows all the mail folders in your email account.

You will always find the first five of those: ''Inbox'' (this is where new emails arrive, by default); Drafts (this is where your draft messages are stored, see later on composing emails); ''Sent'' (messages sent by yourself are stored there); Junk (for Spam messages) and ''Trash'' (for messages that you have deleted). The ''Trash'' folder will be emptied when you log out. In addition to the five folders just described, you might see additional folders like "Mailing Lists" and "Test in the screen shot above. Those have been created by yourself or SWCP, and can be used to organize your email into further categories.

Some of the folders are indicated in bold and carry a number in parentheses to the right of them. This indicates that these folders contain unread messages and the number tells you how many.

To open a folder, you have to click on it once. Its message list will then appear shortly after.

=== The action bar (2) ===
This part of the screen contains a number of icons that allow you to perform different actions, depending on what is being shown in the main part of the window (4). In this example, the 7 icons have the following functions, from left to right:
* ''Refresh Folder:'' checks for new messages in the current folder 
* ''Compose:'' creates a new email message 
* ''Reply:'' creates a new message in reply to the currently selected one; it will be addressed to the sender of the selected message only. 
* ''Reply to all:'' similar to Reply, but the reply will not only be addressed to the sender of the selected message but also to all of its recipients. This makes sense if the message was sent to a group of people and you want all of them to receive your answer. 
* ''Forward Message:'' forwards the currently selected message to another person 
* ''Delete:'' delete the currently selected message(s), that is, move them to Trash 
* ''Print:'' print the currently selected message 

To the right of the action bar, you can see the search field. This field allows you to search all messages in the current folder, much like a search engine on the web. Just enter your search terms and press the Return key. If you are done with your search and want to go back to the original message list, click on the little (X) symbol to the right of the search field.

=== The application bar (3) ===

The three icons at the top right of the screen give you access to different applications which are part of RoundCube. Obviously, this includes the E-Mail component that you have just been looking at. In addition to that, there is also the Address Book which we will describe later. The Personal Settings button gives you access to a number of options that allow you to customize RoundCube according to your needs. Finally, the logout button terminates your RoundCube session. You should always logout after using RoundCube to make sure that nobody else using the same computer will be able to access your emails.

=== The message list (4) ===

This part of the screen is displaying the list of all messages in the folder. To view a message, you have to double-click on it. You can also select a message by clicking on it once and then perform some action on it using one of the buttons in the action bar, e.g. Reply. You can select more than one message by holding the Ctrl key and then clicking on a number of messages in succession. To select a range of messages, select the first message, hold the Shift key and then click on the last message you want to select. Finally, you can also drag-and-drop messages to another folder. Just selected them and then drag them over to one of the folders in the folder list to the left by holding the mouse button. This also provides another way of deleting messages: just drag them into the Trash folder.

You will have noticed that some of the messages in our sample screen were indicated in bold and by a star symbol to the left of them. These are message that have not yet been read by you. A message carrying a little paper clip icon to its right contains an attachment, such as a PDF document or a photo.

== RoundCube Tips ==

=== Using search ===

When entering a search string RoundCube will search in subject and from headers only.

Specific searching is available. Just precede the word to search for with one of the following keywords: from, to, cc, subject or body. Here are a few examples finding emails with 'from' containing 'thomas' and 'subject' containing 'foo'.

from:thomas

subject:foo

=== Preview Pane ===
By default the Preview Pane displays each message as soon as you highlight it in the message list. If you prefer to double-click on the message to view it, do the following:

* In RoundCube click '''Settings'''
* Click '''Mailbox View''' on the left side of the screen
* Uncheck the box next to '''Preview Pane'''
* Click '''Save'''

=== Deleting Messages ===
By default, when you delete a message it is copied to the Trash folder instead of being deleted from the system right away. When you log out, the Trash folder is emptied. Some people run into a problem when the messages they are deleting are so large that they run out of space in the Trash folder. (The error message from RoundCube is, "Unable to move message. Over quota? Trash folder missing?") Here's one solution:
* First, select the messages you want to delete. Use Shift+Click to select a range of messages, or Control+Click to select multiple non-consecutive messages.
* Then hold down the Shift key and press your keyboard's Delete key
This process tells RoundCube to delete the messages immediately, without copying them in the Trash folder first. (It's like the old "delete and expunge" setting in TWIG).

=== Printing Messages ===
To print a message:
* Select the message you want to print from the message list (click it once to highlight it)
* Click the "gear" icon at the top, and you'll get a pull-down menu with several options.
* Select "Print this message".

=== Using the Address Book ===
There are two ways to use the address book. One way is to visit the Address Book from the main page, select a contact, then click the "Compose Mail" icon to send mail to that contact.

The other way is more commonly used. When composing a message, you can type recipient names into the Recipient or CC fields. You can type a whole email address there, or pick an address from your address book. While you type, RoundCube automatically searches for matching names in your address book and displays them. Just type a couple of letters of the person's name and RoundCube will pop up the possible matches.
Press ENTER on the one you want, or click it with the mouse, and then it will be displayed in the recipient box (or CC box if you are adding a CC).

If you don't remember any part of the name you want, type "." and it will display all of your address book entries. That works OK unless you have a very large address book.

If your address book is very large, another option is to open a new browser tab, and log it in to RoundCube and display the address book there. Then you can flip betwee the tabs to see the composition window or the address book window.

=== Folder Management ===
At the bottom of the folder list there is a "gear" icon. Click it to pull down a menu of folder options.
* Compact: If the folder has messages marked for deletion which have not been expunged, this will expunge them.
* Empty: Delete all messages from the folder.
* Manage Folders: From here you can subscribe/unsubscribe to different folders, delete folders, and create new folders.
* Download: This will download a ZIP file containing all the messages from the selected folder to your local machine.

=== Message Templates ===
Roundcube does not yet support "template messages". Here is a workaround that works pretty well though:

# Write your template message and send it to yourself.
# Right-click on the message in your inbox, select Copy To > Drafts.
# Select the message in your Drafts folder. At the top of the message body it will say, "This is a draft message" with an "Edit" link. Click Edit.
# Now customize the message (including the To/Cc list if needed) and send it.

Bonus Tip:
* If you know you will need to do this many times, you can copy the message from your inbox to Drafts several times. Now your Drafts folder will have a handful of copies of the message, and you can quickly pick one to customize and send.

=== Archiving Messages ===
* Log in to roundcube, select a folder
* Click the Gear icon in the lower left under the folder list
* Select [downloadfolder]
* Repeat for each folder you want to archive
The download is a zip file which contains each message in the folder, in .eml format. Most email clients can open .eml files directly.

==See Also==
* [[RoundCube 0.4 Features]]
* [[RoundCube Distribution List]]
[[Category: Email]]
[[Category: Webmail]]
[[Category: RoundCube]]

RoundCube

2024-09-12T00:17:40Z

Cheeks: /* New Version October 2010 */

__NOTOC__
== Welcome to RoundCube ==

RoundCube Webmail is an interface to your email system through the web. It has all the functionality you would expect from a modern email client, including MIME support, address book, folder manipulation, message searching and spell checking. Unlike other webmail clients, its user interface is very much native application-like. This means that it has features like drag-and-drop which you are probably used to from applications on your desktop.

== Login ==

Visit the RoundCube URL in your browser: http://roundcube.swcp.com The site shows the ''Login Screen''. Simply type in your email username and password.

[[Image:rc-login.jpg]] 
''This screenshot shows the RoundCube Login Screen''

== Overview ==

The next screen, after you have logged in, gives you an overview of your Inbox and mail functions.

[[Image:rc-overview.jpg]]

The screen above consists of four main parts. We will now have a closer look at each of them.

=== The folder list (1) ===

The menu at the left hand side of the screen shows all the mail folders in your email account.

You will always find the first five of those: ''Inbox'' (this is where new emails arrive, by default); Drafts (this is where your draft messages are stored, see later on composing emails); ''Sent'' (messages sent by yourself are stored there); Junk (for Spam messages) and ''Trash'' (for messages that you have deleted). The ''Trash'' folder will be emptied when you log out. In addition to the five folders just described, you might see additional folders like "Mailing Lists" and "Test in the screen shot above. Those have been created by yourself or SWCP, and can be used to organize your email into further categories.

Some of the folders are indicated in bold and carry a number in parentheses to the right of them. This indicates that these folders contain unread messages and the number tells you how many.

To open a folder, you have to click on it once. Its message list will then appear shortly after.

=== The action bar (2) ===
This part of the screen contains a number of icons that allow you to perform different actions, depending on what is being shown in the main part of the window (4). In this example, the 7 icons have the following functions, from left to right:
* ''Refresh Folder:'' checks for new messages in the current folder 
* ''Compose:'' creates a new email message 
* ''Reply:'' creates a new message in reply to the currently selected one; it will be addressed to the sender of the selected message only. 
* ''Reply to all:'' similar to Reply, but the reply will not only be addressed to the sender of the selected message but also to all of its recipients. This makes sense if the message was sent to a group of people and you want all of them to receive your answer. 
* ''Forward Message:'' forwards the currently selected message to another person 
* ''Delete:'' delete the currently selected message(s), that is, move them to Trash 
* ''Print:'' print the currently selected message 

To the right of the action bar, you can see the search field. This field allows you to search all messages in the current folder, much like a search engine on the web. Just enter your search terms and press the Return key. If you are done with your search and want to go back to the original message list, click on the little (X) symbol to the right of the search field.

=== The application bar (3) ===

The three icons at the top right of the screen give you access to different applications which are part of RoundCube. Obviously, this includes the E-Mail component that you have just been looking at. In addition to that, there is also the Address Book which we will describe later. The Personal Settings button gives you access to a number of options that allow you to customize RoundCube according to your needs. Finally, the logout button terminates your RoundCube session. You should always logout after using RoundCube to make sure that nobody else using the same computer will be able to access your emails.

=== The message list (4) ===

This part of the screen is displaying the list of all messages in the folder. To view a message, you have to double-click on it. You can also select a message by clicking on it once and then perform some action on it using one of the buttons in the action bar, e.g. Reply. You can select more than one message by holding the Ctrl key and then clicking on a number of messages in succession. To select a range of messages, select the first message, hold the Shift key and then click on the last message you want to select. Finally, you can also drag-and-drop messages to another folder. Just selected them and then drag them over to one of the folders in the folder list to the left by holding the mouse button. This also provides another way of deleting messages: just drag them into the Trash folder.

You will have noticed that some of the messages in our sample screen were indicated in bold and by a star symbol to the left of them. These are message that have not yet been read by you. A message carrying a little paper clip icon to its right contains an attachment, such as a PDF document or a photo.

== RoundCube Tips ==

=== Using search ===

When entering a search string RoundCube will search in subject and from headers only.

Specific searching is available. Just precede the word to search for with one of the following keywords: from, to, cc, subject or body. Here are a few examples finding emails with 'from' containing 'thomas' and 'subject' containing 'foo'.

from:thomas

subject:foo

=== Preview Pane ===
By default the Preview Pane displays each message as soon as you highlight it in the message list. If you prefer to double-click on the message to view it, do the following:

* In RoundCube click '''Settings'''
* Click '''Mailbox View''' on the left side of the screen
* Uncheck the box next to '''Preview Pane'''
* Click '''Save'''

=== Deleting Messages ===
By default, when you delete a message it is copied to the Trash folder instead of being deleted from the system right away. When you log out, the Trash folder is emptied. Some people run into a problem when the messages they are deleting are so large that they run out of space in the Trash folder. (The error message from RoundCube is, "Unable to move message. Over quota? Trash folder missing?") Here's one solution:
* First, select the messages you want to delete. Use Shift+Click to select a range of messages, or Control+Click to select multiple non-consecutive messages.
* Then hold down the Shift key and press your keyboard's Delete key
This process tells RoundCube to delete the messages immediately, without copying them in the Trash folder first. (It's like the old "delete and expunge" setting in TWIG).

=== Printing Messages ===
To print a message:
* Select the message you want to print from the message list (click it once to highlight it)
* Click the "gear" icon at the top, and you'll get a pull-down menu with several options.
* Select "Print this message".

=== Using the Address Book ===
There are two ways to use the address book. One way is to visit the Address Book from the main page, select a contact, then click the "Compose Mail" icon to send mail to that contact.

The other way is more commonly used. When composing a message, you can type recipient names into the Recipient or CC fields. You can type a whole email address there, or pick an address from your address book. While you type, RoundCube automatically searches for matching names in your address book and displays them. Just type a couple of letters of the person's name and RoundCube will pop up the possible matches.
Press ENTER on the one you want, or click it with the mouse, and then it will be displayed in the recipient box (or CC box if you are adding a CC).

If you don't remember any part of the name you want, type "." and it will display all of your address book entries. That works OK unless you have a very large address book.

If your address book is very large, another option is to open a new browser tab, and log it in to RoundCube and display the address book there. Then you can flip betwee the tabs to see the composition window or the address book window.

=== Folder Management ===
At the bottom of the folder list there is a "gear" icon. Click it to pull down a menu of folder options.
* Compact: If the folder has messages marked for deletion which have not been expunged, this will expunge them.
* Empty: Delete all messages from the folder.
* Manage Folders: From here you can subscribe/unsubscribe to different folders, delete folders, and create new folders.
* Download: This will download a ZIP file containing all the messages from the selected folder to your local machine.

=== Message Templates ===
Roundcube does not yet support "template messages". Here is a workaround that works pretty well though:

# Write your template message and send it to yourself.
# Right-click on the message in your inbox, select Copy To > Drafts.
# Select the message in your Drafts folder. At the top of the message body it will say, "This is a draft message" with an "Edit" link. Click Edit.
# Now customize the message (including the To/Cc list if needed) and send it.

Bonus Tip:
* If you know you will need to do this many times, you can copy the message from your inbox to Drafts several times. Now your Drafts folder will have a handful of copies of the message, and you can quickly pick one to customize and send.

=== Archiving Messages ===
* Log in to roundcube, select a folder
* Click the Gear icon in the lower left under the folder list
* Select [downloadfolder]
* Repeat for each folder you want to archive
The download is a zip file which contains each message in the folder, in .eml format. Most email clients can open .eml files directly.

==See Also==
* [[RoundCube 0.4 Features]] (New version Fall 2010)
* [[RoundCube Distribution List]]
[[Category: Email]]
[[Category: Webmail]]
[[Category: RoundCube]]

Maildrop Syntax Tutorial

2024-05-29T21:46:49Z

Cheeks: /* Important Syntax Note */

=An Introduction to Maildrop filtering syntax=

SWCP uses Maildrop to handle its anti-spam filtering. However, Maildrop also allows for a lot of other types of filtering, most of which require manually editing .mailfilter files (and reading your email on the server via TWIG, pine, mutt, etc.). This tutorial covers the basics of manually editing a .mailfilter for an assortment of uses.

Additionally, SWCP provides a web interface for our end users to create a user's .mailfilter file, and most of our users use the web interface to do so. '''Manual editing is incompatible with web interface editing'''. There's a "magic cookie" at the top of the .mailfilter file generated by the web interface. You need to remove that string to keep the web interface from overwriting your changes. Also note that after you remove the magic cookie, changes to the web interface settings will NOT be propagated to your .mailfilter file.

==Getting Started==
If you wish to manually edit your .mailfilter, first log into https://members.swcp.com/mailfilter and set the option "Filtering" to No. Wait 5 minutes or so. You should have a new file called .mailfilter.swcp. From this point you can hand edit the file then rename it to .mailfilter. To keep SWCP or the web interface from mistakenly overwriting your .mailfilter file, be sure to remove the very top line, which will look something like this:

# SWCP:MAILFILTER:NNNNN Version n.n.n

===Important Syntax Note===
For the most part the .mailfilter syntax is pretty standard-looking code with arbitrary white space between elements. The one big exception to this is the opening brace on an "if" statement. It MUST be on a line by itself, not at the end of the line with the "if" on it. For example:

<pre>
BAD (will produce mail delivery errors):
if (/strange ach offer/:b) {
$THISISSPAM = 1
}

GOOD:
if (/strange ach offer/:b)
{
$THISISSPAM = 1
}
</pre>

=Variables=
Variables can be declared as below.

Without Quotes
DEFAULT=/var/mail/sampleuser

With variable substitution
SPAMCAN=/var/spool/mail/spamdrop/$LOGNAME

With quotes
SUPPORT="/users/sampleuser/mail/support"

With quotes and variable substitution
HELP="/users/$LOGNAME/mail/help"

=Logging your filtered email=
I have found that logging filtered email makes troubleshooting much easier.
To make this function operate you'll want to set the logfile variable. Then in
each recipe add a log line with a comment. Here's an example.

logfile "/home/sampleuser/.mailfilter.log"
...

if (/^To:.*sampleuser@swcp.com /)
{
log "Ptrn: sampleuser@swcp.com whitelist"
to "$DEFAULT"
}

Now when this rule is matched and delivers a message your .mailfilter.log will
have a set of lines in it similar to this.

Ptrn: sampleuser@swcp.com whitelist
Date: Wed Apr 23 17:21:44 2003
From: Some Sender <someone@somewhere.com>
Subj: Some Subject
File: /var/spool/mail/sampleuser

As you can see this makes finding an elusive problem somewhat easier. There is one
unfortunate side effect, of course there had to be one :-) Depending on how quickly your
mailserver is getting email you may find that the 'Ptrn:' line and the 'Date: From: Subj:
File:' lines are out of sync. These are difficult problems to solve without modifying the
source to maildrop.

=Filter Contents of the To: Cc: From: or Subject: fields.=
Visit http://www.flounder.net/~mrsam/maildrop/maildropfilter.html for complete regex syntax.
<pre>
if (/^To:.*sampleuser@swcp.com /)
{
to "$DEFAULT"
}

if (/^Cc:.*help@swcp.com/ )
{
to "$HELP"
}

if (/^From: My Enemy <anotheruser@swcp.com>/)
{
to "$SPAMCAN"
}

if (/^Subject: About your puppies/)
{
to "$DEFAULT"
}
</pre>

=Filter Contents of the header, body, both, or case.=
You can match header, body, header & body, or case (upper or lower).

Header is always assumed, so you don't have to put :h after most matches
Be very careful to limit the size of your search if you use :b see below.

* :h = match in the header only
* :b = match in the body only
* :w = match in the header and the body
* :D = match case
* :p = match only the first 100 lines of the body (SWCP Specific)

==First Version==
This version matches the words opt-in, opt in, opt-out, opt out in the body with no reguard for the size of the message.

if (/(opt-in|opt in|opt-out|opt out) /:b )
{
to "$SPAMCAN"
}

==A More Complicated Version==
This version matches the words opt-in, opt in, opt-out, opt out in the body but constrains the message size to less than 500 lines and less than 15 kilobytes.

if (($LINES < 500 && $SIZE < 15000) && /(opt-in|opt in|opt-out|opt out) /:b)
{
to "$SPAMCAN"
}

=Using Matching=
If you have multiple entries to match say from the Subject line, consider the following.

The special character '!' tells maildrop to stick everything it matches up to the end of line '$' into one of its special MATCH variables.

'''Note''': It should be noted that maildrop has (what I consider to be) a documented bug. Different types of matches cause different MATCH variables to be used. In particular if statements using this match syntax dump their variable contents into MATCH2, foreach matches dump their match contents into a variable called MATCH, see below.
<pre>
if (/^Subject: *!.*$/)
{
if ($MATCH2 =~ /Updates from the hospital about (mom|dad|brother)/ )
{
to "$DEFAULT"
}

if ($MATCH2 =~ /Win / && $MATCH2 =~ /Opt/:D && /casino/:p)
{
to "$SPAMCAN"
}
}
</pre>

=Looping with Foreach=
If you wish to match to & cc in the same statement you must use a foreach
<pre>
foreach /^(To|Cc): *!.*$/
{
if ( $MATCH =~ /@netris.com/)
{
to "$DEFAULT"
}

if ($MATCH =~ /rob@nowhere.com / && /casino/:p )
{
to "$SPAMCAN"
}
}
</pre>

=Dropping a message entirely=
If you want to send something to /dev/null, use the keyword 'exit'. It should send any matched email messages to /dev/null.

if ( /To: sampleuser@netris.com/)
{
exit
}

=Filter Then Forward=
If you want to filter then forward or cc a message, simply place a ! at the begining of your delivery line. This tells maildrop to forward all mail matching that criteria to someone@someotheraddress.com. If you want to forward all email simply put the 'cc' line outside the body of the regex.

if ( /To: sampleuser@netris.com/)
{
cc "!someone@someotheraddress.com"
}

=Modify The Message=
You can use the "xfilter" command to modify the message "in place" before delivery. For example, if you wanted to tag the subject line of any message from your friend Bubbba, you could use this:
<pre>
# Flag messages from Bubba in the subject
if (/^From:.*bubba@bubbaville.com/)
{
xfilter "sed -e 's/^Subject: /Subject: [FROM BUBBA] /'"
}
</pre>

=Testing your new filter rules=

Log into a a host that is running maildrop and run the following command*:

maildrop -V 4 -d logname < msg.txt

Where logname is your username and msg.txt is a file containing 1 email message saved from pine or mutt.

'''You'll probably want to log into a host other than your mailserver.''' If your system has a systemwide maildroprc you'll see all the debug from that too. That's probably not what you want :-)

=A real example=
<pre>
MAILDIR="/users/$LOGNAME/mail"
DEFAULT="/var/mail/$LOGNAME"
SPAMCAN="/users/$LOGNAME/mail/SPAM"
logfile "/users/$LOGNAME/maildrop_log"
#
if(/^Subject: *!.*$/)
{
if($MATCH2 =~ /Dialup Session Report/)
{
log "Ptrn: Dialup Session Report"
to "$MAILDIR/portmasters"
}
if($MATCH2 =~ /OMS#.*Path Built/)
{
log "Ptrn: Path Built"
to "$MAILDIR/pathbuilt"
}
if($MATCH2 =~ /Domain request:/)
{
"Ptrn: Domain request"
to "$MAILDIR/domreg"
}
}
# end of Subject exceptions
#
# begin To/Cc exceptions
foreach /^(To|Cc): *!.*$/
{
if($MATCH =~ /ilikespam@/)
{
log "Ptrn: ilikespam spam"
to "$MAILDIR/throwaway"
}
if($MATCH =~ /abc@/)
{
log "Ptrn: abc spam"
to "$MAILDIR/throwaway"
}
if($MATCH =~ /puppyfriends@yahoogroups.com/)
{
log "Ptrn: Puppy email"
to "$MAILDIR/puppy"
}
}
# end of To and Cc exceptions
#
# beginning of From exceptions
if(/^From:*!.*$/)
{
if($MATCH2 =~ /joejoe@uswest.com/)
{
log "Ptrn: joejoe"
to "$MAILDIR/joe"
}
if($MATCH2 =~ /catchthisemail@swcp.com/)
{
log "Ptrn: catchthisemail spam"
to "$MAILDIR/junk"
}
if($MATCH2 =~ /((samplemom|sampledad|samplebrother|sistersample)@swcp.com)|marie@nm.net/)
{
log "Ptrn: family match"
to "$DEFAULT"
}
if($MATCH2 =~ /(majordomo@swcp.com|replies@opensrs.org)/)
{
log "Ptrn: majordomo-opensrs"
to "$DEFAULT"
}
}
# asdf end of From: exceptions
#
log "Ptrn: final match"
to "$SPAMCAN"
</pre>

----

''If you have questions, please email the [mailto:help@swcp.com SWCP Helpdesk].

Maildrop Syntax Tutorial

2024-05-29T21:46:34Z

Cheeks: /* Getting Started */

=An Introduction to Maildrop filtering syntax=

SWCP uses Maildrop to handle its anti-spam filtering. However, Maildrop also allows for a lot of other types of filtering, most of which require manually editing .mailfilter files (and reading your email on the server via TWIG, pine, mutt, etc.). This tutorial covers the basics of manually editing a .mailfilter for an assortment of uses.

Additionally, SWCP provides a web interface for our end users to create a user's .mailfilter file, and most of our users use the web interface to do so. '''Manual editing is incompatible with web interface editing'''. There's a "magic cookie" at the top of the .mailfilter file generated by the web interface. You need to remove that string to keep the web interface from overwriting your changes. Also note that after you remove the magic cookie, changes to the web interface settings will NOT be propagated to your .mailfilter file.

==Getting Started==
If you wish to manually edit your .mailfilter, first log into https://members.swcp.com/mailfilter and set the option "Filtering" to No. Wait 5 minutes or so. You should have a new file called .mailfilter.swcp. From this point you can hand edit the file then rename it to .mailfilter. To keep SWCP or the web interface from mistakenly overwriting your .mailfilter file, be sure to remove the very top line, which will look something like this:

# SWCP:MAILFILTER:NNNNN Version n.n.n

===Important Syntax Note===
For the most part the .mailfilter syntax is pretty standard-looking code with arbitrary white space between elements. The one big exception to this is the opening brace on an "if" statement. It MUST be on a line by itself, not at the end of the line with the "if" on it. For example:

<pre>
BAD (will produce mail delivery errors):
if (/strange ach offer/:b) {
$THISISSPAM = 1
}

GOOD:
if (/strange ach offer/:b)
{
$THISISSPAM = 1
}

=Variables=
Variables can be declared as below.

Without Quotes
DEFAULT=/var/mail/sampleuser

With variable substitution
SPAMCAN=/var/spool/mail/spamdrop/$LOGNAME

With quotes
SUPPORT="/users/sampleuser/mail/support"

With quotes and variable substitution
HELP="/users/$LOGNAME/mail/help"

=Logging your filtered email=
I have found that logging filtered email makes troubleshooting much easier.
To make this function operate you'll want to set the logfile variable. Then in
each recipe add a log line with a comment. Here's an example.

logfile "/home/sampleuser/.mailfilter.log"
...

if (/^To:.*sampleuser@swcp.com /)
{
log "Ptrn: sampleuser@swcp.com whitelist"
to "$DEFAULT"
}

Now when this rule is matched and delivers a message your .mailfilter.log will
have a set of lines in it similar to this.

Ptrn: sampleuser@swcp.com whitelist
Date: Wed Apr 23 17:21:44 2003
From: Some Sender <someone@somewhere.com>
Subj: Some Subject
File: /var/spool/mail/sampleuser

As you can see this makes finding an elusive problem somewhat easier. There is one
unfortunate side effect, of course there had to be one :-) Depending on how quickly your
mailserver is getting email you may find that the 'Ptrn:' line and the 'Date: From: Subj:
File:' lines are out of sync. These are difficult problems to solve without modifying the
source to maildrop.

=Filter Contents of the To: Cc: From: or Subject: fields.=
Visit http://www.flounder.net/~mrsam/maildrop/maildropfilter.html for complete regex syntax.
<pre>
if (/^To:.*sampleuser@swcp.com /)
{
to "$DEFAULT"
}

if (/^Cc:.*help@swcp.com/ )
{
to "$HELP"
}

if (/^From: My Enemy <anotheruser@swcp.com>/)
{
to "$SPAMCAN"
}

if (/^Subject: About your puppies/)
{
to "$DEFAULT"
}
</pre>

=Filter Contents of the header, body, both, or case.=
You can match header, body, header & body, or case (upper or lower).

Header is always assumed, so you don't have to put :h after most matches
Be very careful to limit the size of your search if you use :b see below.

* :h = match in the header only
* :b = match in the body only
* :w = match in the header and the body
* :D = match case
* :p = match only the first 100 lines of the body (SWCP Specific)

==First Version==
This version matches the words opt-in, opt in, opt-out, opt out in the body with no reguard for the size of the message.

if (/(opt-in|opt in|opt-out|opt out) /:b )
{
to "$SPAMCAN"
}

==A More Complicated Version==
This version matches the words opt-in, opt in, opt-out, opt out in the body but constrains the message size to less than 500 lines and less than 15 kilobytes.

if (($LINES < 500 && $SIZE < 15000) && /(opt-in|opt in|opt-out|opt out) /:b)
{
to "$SPAMCAN"
}

=Using Matching=
If you have multiple entries to match say from the Subject line, consider the following.

The special character '!' tells maildrop to stick everything it matches up to the end of line '$' into one of its special MATCH variables.

'''Note''': It should be noted that maildrop has (what I consider to be) a documented bug. Different types of matches cause different MATCH variables to be used. In particular if statements using this match syntax dump their variable contents into MATCH2, foreach matches dump their match contents into a variable called MATCH, see below.
<pre>
if (/^Subject: *!.*$/)
{
if ($MATCH2 =~ /Updates from the hospital about (mom|dad|brother)/ )
{
to "$DEFAULT"
}

if ($MATCH2 =~ /Win / && $MATCH2 =~ /Opt/:D && /casino/:p)
{
to "$SPAMCAN"
}
}
</pre>

=Looping with Foreach=
If you wish to match to & cc in the same statement you must use a foreach
<pre>
foreach /^(To|Cc): *!.*$/
{
if ( $MATCH =~ /@netris.com/)
{
to "$DEFAULT"
}

if ($MATCH =~ /rob@nowhere.com / && /casino/:p )
{
to "$SPAMCAN"
}
}
</pre>

=Dropping a message entirely=
If you want to send something to /dev/null, use the keyword 'exit'. It should send any matched email messages to /dev/null.

if ( /To: sampleuser@netris.com/)
{
exit
}

=Filter Then Forward=
If you want to filter then forward or cc a message, simply place a ! at the begining of your delivery line. This tells maildrop to forward all mail matching that criteria to someone@someotheraddress.com. If you want to forward all email simply put the 'cc' line outside the body of the regex.

if ( /To: sampleuser@netris.com/)
{
cc "!someone@someotheraddress.com"
}

=Modify The Message=
You can use the "xfilter" command to modify the message "in place" before delivery. For example, if you wanted to tag the subject line of any message from your friend Bubbba, you could use this:
<pre>
# Flag messages from Bubba in the subject
if (/^From:.*bubba@bubbaville.com/)
{
xfilter "sed -e 's/^Subject: /Subject: [FROM BUBBA] /'"
}
</pre>

=Testing your new filter rules=

Log into a a host that is running maildrop and run the following command*:

maildrop -V 4 -d logname < msg.txt

Where logname is your username and msg.txt is a file containing 1 email message saved from pine or mutt.

'''You'll probably want to log into a host other than your mailserver.''' If your system has a systemwide maildroprc you'll see all the debug from that too. That's probably not what you want :-)

=A real example=
<pre>
MAILDIR="/users/$LOGNAME/mail"
DEFAULT="/var/mail/$LOGNAME"
SPAMCAN="/users/$LOGNAME/mail/SPAM"
logfile "/users/$LOGNAME/maildrop_log"
#
if(/^Subject: *!.*$/)
{
if($MATCH2 =~ /Dialup Session Report/)
{
log "Ptrn: Dialup Session Report"
to "$MAILDIR/portmasters"
}
if($MATCH2 =~ /OMS#.*Path Built/)
{
log "Ptrn: Path Built"
to "$MAILDIR/pathbuilt"
}
if($MATCH2 =~ /Domain request:/)
{
"Ptrn: Domain request"
to "$MAILDIR/domreg"
}
}
# end of Subject exceptions
#
# begin To/Cc exceptions
foreach /^(To|Cc): *!.*$/
{
if($MATCH =~ /ilikespam@/)
{
log "Ptrn: ilikespam spam"
to "$MAILDIR/throwaway"
}
if($MATCH =~ /abc@/)
{
log "Ptrn: abc spam"
to "$MAILDIR/throwaway"
}
if($MATCH =~ /puppyfriends@yahoogroups.com/)
{
log "Ptrn: Puppy email"
to "$MAILDIR/puppy"
}
}
# end of To and Cc exceptions
#
# beginning of From exceptions
if(/^From:*!.*$/)
{
if($MATCH2 =~ /joejoe@uswest.com/)
{
log "Ptrn: joejoe"
to "$MAILDIR/joe"
}
if($MATCH2 =~ /catchthisemail@swcp.com/)
{
log "Ptrn: catchthisemail spam"
to "$MAILDIR/junk"
}
if($MATCH2 =~ /((samplemom|sampledad|samplebrother|sistersample)@swcp.com)|marie@nm.net/)
{
log "Ptrn: family match"
to "$DEFAULT"
}
if($MATCH2 =~ /(majordomo@swcp.com|replies@opensrs.org)/)
{
log "Ptrn: majordomo-opensrs"
to "$DEFAULT"
}
}
# asdf end of From: exceptions
#
log "Ptrn: final match"
to "$SPAMCAN"
</pre>

----

''If you have questions, please email the [mailto:help@swcp.com SWCP Helpdesk].

KB Email-3

2023-10-05T00:19:25Z

Cheeks: /* See Also */

==SWCP Email Server Settings==

This article contains the info you need to set up any email client to work with the SWCP mail servers.

* Outgoing mail server: mail.swcp.com
** Authenticated SMTP Port: 465
** Use SSL with Authenticated SMTP: Yes
*** or for TLS (mac mail tends to like this better)
**** Authenticated SMTP Port: 587
**** Use TLS with Authenticated SMTP: Yes
** What about good old port 25?
*** Port 25 works only under certain conditions, and is no longer intended for email client interaction. It is best to use Authenticated SMTP which should always work.

* Incoming mail server: mail.swcp.com
** Incoming Protocols: IMAP or POP. Again, we recommend you ONLY use the SSL versions of these services.
*** SSL IMAP Port: 993 '''(Recommended)'''
*** Standard (insecure) IMAP port: 143
*** SSL POP Port: 995
*** Standard (insecure) POP Port: 110

== See Also ==

* [[Authenticated SMTP]] - includes instructions for a variety of email software
* [[KB Email-1|Outlook 2003 with Auth SMTP and IMAP SSL]]
* [[KB Email-2|Outlook 2007 with Auth SMTP and IMAP SSL]]
* [[Outlook 365 on Windows 10]]
* [[Apple Mail with Auth SMTP and IMAP SSL]]
* [[Configure iPhone or iPad for SWCP Email]]
* [[Configure K-9 on Android for SWCP Email]]
* [[Configure Thunderbird on Linux, MacOSX or Windows]]
* [[Configure Sendmail Client for Auth SMTP]] - Only useful if you run your own sendmail server
* [[Maximum Email Message Sizes]] - for different ISPs
* [[Use SPF to prevent Gmail bounces]]

[[Category: Email]]
[[Category: Webmail]]

RoundCube

2023-07-22T23:37:30Z

Cheeks: /* See Also */

__NOTOC__
== Welcome to RoundCube ==

RoundCube Webmail is an interface to your email system through the web. It has all the functionality you would expect from a modern email client, including MIME support, address book, folder manipulation, message searching and spell checking. Unlike other webmail clients, its user interface is very much native application-like. This means that it has features like drag-and-drop which you are probably used to from applications on your desktop.

== New Version October 2010 ==
We have just rolled out an updated version of RoundCube. See [[RoundCube 0.4 Features]] for a run-down of what's new and different.

== Login ==

Visit the RoundCube URL in your browser: http://roundcube.swcp.com The site shows the ''Login Screen''. Simply type in your email username and password.

[[Image:rc-login.jpg]] 
''This screenshot shows the RoundCube Login Screen''

== Overview ==

The next screen, after you have logged in, gives you an overview of your Inbox and mail functions.

[[Image:rc-overview.jpg]]

The screen above consists of four main parts. We will now have a closer look at each of them.

=== The folder list (1) ===

The menu at the left hand side of the screen shows all the mail folders in your email account.

You will always find the first five of those: ''Inbox'' (this is where new emails arrive, by default); Drafts (this is where your draft messages are stored, see later on composing emails); ''Sent'' (messages sent by yourself are stored there); Junk (for Spam messages) and ''Trash'' (for messages that you have deleted). The ''Trash'' folder will be emptied when you log out. In addition to the five folders just described, you might see additional folders like "Mailing Lists" and "Test in the screen shot above. Those have been created by yourself or SWCP, and can be used to organize your email into further categories.

Some of the folders are indicated in bold and carry a number in parentheses to the right of them. This indicates that these folders contain unread messages and the number tells you how many.

To open a folder, you have to click on it once. Its message list will then appear shortly after.

=== The action bar (2) ===
This part of the screen contains a number of icons that allow you to perform different actions, depending on what is being shown in the main part of the window (4). In this example, the 7 icons have the following functions, from left to right:
* ''Refresh Folder:'' checks for new messages in the current folder 
* ''Compose:'' creates a new email message 
* ''Reply:'' creates a new message in reply to the currently selected one; it will be addressed to the sender of the selected message only. 
* ''Reply to all:'' similar to Reply, but the reply will not only be addressed to the sender of the selected message but also to all of its recipients. This makes sense if the message was sent to a group of people and you want all of them to receive your answer. 
* ''Forward Message:'' forwards the currently selected message to another person 
* ''Delete:'' delete the currently selected message(s), that is, move them to Trash 
* ''Print:'' print the currently selected message 

To the right of the action bar, you can see the search field. This field allows you to search all messages in the current folder, much like a search engine on the web. Just enter your search terms and press the Return key. If you are done with your search and want to go back to the original message list, click on the little (X) symbol to the right of the search field.

=== The application bar (3) ===

The three icons at the top right of the screen give you access to different applications which are part of RoundCube. Obviously, this includes the E-Mail component that you have just been looking at. In addition to that, there is also the Address Book which we will describe later. The Personal Settings button gives you access to a number of options that allow you to customize RoundCube according to your needs. Finally, the logout button terminates your RoundCube session. You should always logout after using RoundCube to make sure that nobody else using the same computer will be able to access your emails.

=== The message list (4) ===

This part of the screen is displaying the list of all messages in the folder. To view a message, you have to double-click on it. You can also select a message by clicking on it once and then perform some action on it using one of the buttons in the action bar, e.g. Reply. You can select more than one message by holding the Ctrl key and then clicking on a number of messages in succession. To select a range of messages, select the first message, hold the Shift key and then click on the last message you want to select. Finally, you can also drag-and-drop messages to another folder. Just selected them and then drag them over to one of the folders in the folder list to the left by holding the mouse button. This also provides another way of deleting messages: just drag them into the Trash folder.

You will have noticed that some of the messages in our sample screen were indicated in bold and by a star symbol to the left of them. These are message that have not yet been read by you. A message carrying a little paper clip icon to its right contains an attachment, such as a PDF document or a photo.

== RoundCube Tips ==

=== Using search ===

When entering a search string RoundCube will search in subject and from headers only.

Specific searching is available. Just precede the word to search for with one of the following keywords: from, to, cc, subject or body. Here are a few examples finding emails with 'from' containing 'thomas' and 'subject' containing 'foo'.

from:thomas

subject:foo

=== Preview Pane ===
By default the Preview Pane displays each message as soon as you highlight it in the message list. If you prefer to double-click on the message to view it, do the following:

* In RoundCube click '''Settings'''
* Click '''Mailbox View''' on the left side of the screen
* Uncheck the box next to '''Preview Pane'''
* Click '''Save'''

=== Deleting Messages ===
By default, when you delete a message it is copied to the Trash folder instead of being deleted from the system right away. When you log out, the Trash folder is emptied. Some people run into a problem when the messages they are deleting are so large that they run out of space in the Trash folder. (The error message from RoundCube is, "Unable to move message. Over quota? Trash folder missing?") Here's one solution:
* First, select the messages you want to delete. Use Shift+Click to select a range of messages, or Control+Click to select multiple non-consecutive messages.
* Then hold down the Shift key and press your keyboard's Delete key
This process tells RoundCube to delete the messages immediately, without copying them in the Trash folder first. (It's like the old "delete and expunge" setting in TWIG).

=== Printing Messages ===
To print a message:
* Select the message you want to print from the message list (click it once to highlight it)
* Click the "gear" icon at the top, and you'll get a pull-down menu with several options.
* Select "Print this message".

=== Using the Address Book ===
There are two ways to use the address book. One way is to visit the Address Book from the main page, select a contact, then click the "Compose Mail" icon to send mail to that contact.

The other way is more commonly used. When composing a message, you can type recipient names into the Recipient or CC fields. You can type a whole email address there, or pick an address from your address book. While you type, RoundCube automatically searches for matching names in your address book and displays them. Just type a couple of letters of the person's name and RoundCube will pop up the possible matches.
Press ENTER on the one you want, or click it with the mouse, and then it will be displayed in the recipient box (or CC box if you are adding a CC).

If you don't remember any part of the name you want, type "." and it will display all of your address book entries. That works OK unless you have a very large address book.

If your address book is very large, another option is to open a new browser tab, and log it in to RoundCube and display the address book there. Then you can flip betwee the tabs to see the composition window or the address book window.

=== Folder Management ===
At the bottom of the folder list there is a "gear" icon. Click it to pull down a menu of folder options.
* Compact: If the folder has messages marked for deletion which have not been expunged, this will expunge them.
* Empty: Delete all messages from the folder.
* Manage Folders: From here you can subscribe/unsubscribe to different folders, delete folders, and create new folders.
* Download: This will download a ZIP file containing all the messages from the selected folder to your local machine.

=== Message Templates ===
Roundcube does not yet support "template messages". Here is a workaround that works pretty well though:

# Write your template message and send it to yourself.
# Right-click on the message in your inbox, select Copy To > Drafts.
# Select the message in your Drafts folder. At the top of the message body it will say, "This is a draft message" with an "Edit" link. Click Edit.
# Now customize the message (including the To/Cc list if needed) and send it.

Bonus Tip:
* If you know you will need to do this many times, you can copy the message from your inbox to Drafts several times. Now your Drafts folder will have a handful of copies of the message, and you can quickly pick one to customize and send.

=== Archiving Messages ===
* Log in to roundcube, select a folder
* Click the Gear icon in the lower left under the folder list
* Select [downloadfolder]
* Repeat for each folder you want to archive
The download is a zip file which contains each message in the folder, in .eml format. Most email clients can open .eml files directly.

==See Also==
* [[RoundCube 0.4 Features]] (New version Fall 2010)
* [[RoundCube Distribution List]]
[[Category: Email]]
[[Category: Webmail]]
[[Category: RoundCube]]

SWCP Webmail Options

2023-07-22T23:36:59Z

Cheeks: /* See Also */

Over time SWCP has provided several different webmail programs. As we have merged with other ISPs, we have embraced the webmail systems used by users of those systems. Currently we have these available: Twig, Horde, SquirrelMail, and [[RoundCube]].

Of these, [[RoundCube]] is the best and most modern webmail program. It is a true "Web 2.0" application, which means it behaves much more like a native desktop application. (For example you can do things like delete a message without having to go through a full screen refresh, which makes it much more responsive).

In 2010, we are working toward streamlining our webmail setup. We plan to migrate all users to [[RoundCube]].

If you have been using one of the other webmail interfaces and you want to try [[RoundCube]], just visit this link: http://roundcube.swcp.com

If you have address book entries in another webmail program and you would like us to import them to [[RoundCube]], email help@swcp.com and we'll copy them for you.

==See Also==
* [[RoundCube|RoundCube Tutorial]]

[[Category: Email]]
[[Category: Webmail]]
[[Category: RoundCube]]

Category:RoundCube

2023-07-22T23:36:25Z

Cheeks: Created page with "Articles about RoundCube"

Articles about RoundCube

RoundCube Distribution List

2023-07-22T23:36:12Z

Cheeks: /* Send Mail To Your Distribution List */

__NOTOC__
In the RoundCube address book, you can make a distribution list. This is a set of contacts grouped together so you can email them a message all at once.

The contacts interface is a little different depending on which theme you are using. So in the instructions below, some of the screen elements might be in slightly different places.

==Getting Started==
First, log in to RoundCube. Then click the Contacts button.

If you are using the Classic theme, the Contacts button is in the row of icons across the top. If you are in the Elastic theme, it will be in the column of icons on the left hand side.

===Add Contacts===
You should see two window panes for the contacts. The left lists the Groups and the right lists individual contacts. The Groups should have at least one group listed, called Personal Addresses.

The first step is to add some contacts. In the Classic theme, there's a "Create New Contact" icon right above the contacts pane. In Elastic it's a "Create" icon above and to the right of the contacts pane. Click that, fill in the name and email address of the new contact, then click Save.

===Add a Group===
After you have a few contacts, you're ready to create a group. In Classic, at the bottom of the Groups pane there is a plus sign "+" and you click that to add a new group. In Elastic, at the top of the Groups pane there is a 3-dots menu. Click that and select "Add group". In our example let's say you created a new group called "Friends". After you save, you should see a Friends group in the groups pane.

Now, you can drag-and-drop contacts from the contacts pane to the Friends group. As you move them to the Friends group, '''they will not disappear''' from the contacts list on the right. That means you can add one contact to as many different groups as you like.

Click on the group on the left to see the list of contacts in that group. To get back to the list of all your contacts, click Personal Addresses at the top.

==Send Mail To Your Distribution List==
Now when you compose a new message, you can start to type the name of the group (e.g. friends) and it will be offered up for you to click. When you select it, it will put all the addresses into the To: line for you.

If you don't want the recipients to see the addresses of the other recipients, you can put them on a BCC line instead. In Classic click the little "Add Bcc" link below the To line. If Elastic, click the "+" at the end of the line and select BCC.

==See Also==
[[Category: Email]]
[[Category: RoundCube]]

RoundCube Distribution List

2023-07-22T23:35:13Z

Cheeks: /* Add a Group */

__NOTOC__
In the RoundCube address book, you can make a distribution list. This is a set of contacts grouped together so you can email them a message all at once.

The contacts interface is a little different depending on which theme you are using. So in the instructions below, some of the screen elements might be in slightly different places.

==Getting Started==
First, log in to RoundCube. Then click the Contacts button.

If you are using the Classic theme, the Contacts button is in the row of icons across the top. If you are in the Elastic theme, it will be in the column of icons on the left hand side.

===Add Contacts===
You should see two window panes for the contacts. The left lists the Groups and the right lists individual contacts. The Groups should have at least one group listed, called Personal Addresses.

The first step is to add some contacts. In the Classic theme, there's a "Create New Contact" icon right above the contacts pane. In Elastic it's a "Create" icon above and to the right of the contacts pane. Click that, fill in the name and email address of the new contact, then click Save.

===Add a Group===
After you have a few contacts, you're ready to create a group. In Classic, at the bottom of the Groups pane there is a plus sign "+" and you click that to add a new group. In Elastic, at the top of the Groups pane there is a 3-dots menu. Click that and select "Add group". In our example let's say you created a new group called "Friends". After you save, you should see a Friends group in the groups pane.

Now, you can drag-and-drop contacts from the contacts pane to the Friends group. As you move them to the Friends group, '''they will not disappear''' from the contacts list on the right. That means you can add one contact to as many different groups as you like.

Click on the group on the left to see the list of contacts in that group. To get back to the list of all your contacts, click Personal Addresses at the top.

==Send Mail To Your Distribution List==
Now when you compose a new message, you can start to type the name of the group (e.g. friends) and it will be offered up for you to click. When you select it, it will put all the addresses into the To: line for you.

If you don't want the recipients to see the addresses of the other recipients, you can put them on a BCC line instead. In Classic click the little "Add Bcc" below the To line. If Elastic, click the "+" at the end of the line and select BCC.

==See Also==
[[Category: Email]]
[[Category: RoundCube]]

RoundCube Distribution List

2023-07-22T23:33:43Z

Cheeks:

__NOTOC__
In the RoundCube address book, you can make a distribution list. This is a set of contacts grouped together so you can email them a message all at once.

The contacts interface is a little different depending on which theme you are using. So in the instructions below, some of the screen elements might be in slightly different places.

==Getting Started==
First, log in to RoundCube. Then click the Contacts button.

If you are using the Classic theme, the Contacts button is in the row of icons across the top. If you are in the Elastic theme, it will be in the column of icons on the left hand side.

===Add Contacts===
You should see two window panes for the contacts. The left lists the Groups and the right lists individual contacts. The Groups should have at least one group listed, called Personal Addresses.

The first step is to add some contacts. In the Classic theme, there's a "Create New Contact" icon right above the contacts pane. In Elastic it's a "Create" icon above and to the right of the contacts pane. Click that, fill in the name and email address of the new contact, then click Save.

===Add a Group===
After you have a few contacts, you're ready to create a group. In Classic, at the bottom of the Groups pane there is a plus sign "+" and you click that to add a new group. In Elastic, at the top of the Groups pane there is a 3-dots menu. Click that and select "Add group". In our example let's say you created a new group called "Friends". After you save, you should see a Friends group in the groups pane.

Now, you can drag-and-drop contacts from the contacts pane to the Friends group. As you move them to the Friends group, they '''will not disappear''' from the contacts list on the right. That means you can add one contact to as many different groups as you like.

If you click on the group on the left, you see the list of contacts in that group. To get back to the list of all your contacts, click Personal Addresses at the top.

==Send Mail To Your Distribution List==
Now when you compose a new message, you can start to type the name of the group (e.g. friends) and it will be offered up for you to click. When you select it, it will put all the addresses into the To: line for you.

If you don't want the recipients to see the addresses of the other recipients, you can put them on a BCC line instead. In Classic click the little "Add Bcc" below the To line. If Elastic, click the "+" at the end of the line and select BCC.

==See Also==
[[Category: Email]]
[[Category: RoundCube]]

RoundCube Distribution List

2023-07-22T23:33:29Z

Cheeks: Created page with "In the RoundCube address book, you can make a distribution list. This is a set of contacts grouped together so you can email them a message all at once. The contacts interface ..."

In the RoundCube address book, you can make a distribution list. This is a set of contacts grouped together so you can email them a message all at once.

The contacts interface is a little different depending on which theme you are using. So in the instructions below, some of the screen elements might be in slightly different places.

==Getting Started==
First, log in to RoundCube. Then click the Contacts button.

If you are using the Classic theme, the Contacts button is in the row of icons across the top. If you are in the Elastic theme, it will be in the column of icons on the left hand side.

===Add Contacts===
You should see two window panes for the contacts. The left lists the Groups and the right lists individual contacts. The Groups should have at least one group listed, called Personal Addresses.

The first step is to add some contacts. In the Classic theme, there's a "Create New Contact" icon right above the contacts pane. In Elastic it's a "Create" icon above and to the right of the contacts pane. Click that, fill in the name and email address of the new contact, then click Save.

===Add a Group===
After you have a few contacts, you're ready to create a group. In Classic, at the bottom of the Groups pane there is a plus sign "+" and you click that to add a new group. In Elastic, at the top of the Groups pane there is a 3-dots menu. Click that and select "Add group". In our example let's say you created a new group called "Friends". After you save, you should see a Friends group in the groups pane.

Now, you can drag-and-drop contacts from the contacts pane to the Friends group. As you move them to the Friends group, they '''will not disappear''' from the contacts list on the right. That means you can add one contact to as many different groups as you like.

If you click on the group on the left, you see the list of contacts in that group. To get back to the list of all your contacts, click Personal Addresses at the top.

==Send Mail To Your Distribution List==
Now when you compose a new message, you can start to type the name of the group (e.g. friends) and it will be offered up for you to click. When you select it, it will put all the addresses into the To: line for you.

If you don't want the recipients to see the addresses of the other recipients, you can put them on a BCC line instead. In Classic click the little "Add Bcc" below the To line. If Elastic, click the "+" at the end of the line and select BCC.

==See Also==
[[Category: Email]]
[[Category: RoundCube]]

RoundCube

2023-07-22T23:01:38Z

Cheeks: /* See Also */

__NOTOC__
== Welcome to RoundCube ==

RoundCube Webmail is an interface to your email system through the web. It has all the functionality you would expect from a modern email client, including MIME support, address book, folder manipulation, message searching and spell checking. Unlike other webmail clients, its user interface is very much native application-like. This means that it has features like drag-and-drop which you are probably used to from applications on your desktop.

== New Version October 2010 ==
We have just rolled out an updated version of RoundCube. See [[RoundCube 0.4 Features]] for a run-down of what's new and different.

== Login ==

Visit the RoundCube URL in your browser: http://roundcube.swcp.com The site shows the ''Login Screen''. Simply type in your email username and password.

[[Image:rc-login.jpg]] 
''This screenshot shows the RoundCube Login Screen''

== Overview ==

The next screen, after you have logged in, gives you an overview of your Inbox and mail functions.

[[Image:rc-overview.jpg]]

The screen above consists of four main parts. We will now have a closer look at each of them.

=== The folder list (1) ===

The menu at the left hand side of the screen shows all the mail folders in your email account.

You will always find the first five of those: ''Inbox'' (this is where new emails arrive, by default); Drafts (this is where your draft messages are stored, see later on composing emails); ''Sent'' (messages sent by yourself are stored there); Junk (for Spam messages) and ''Trash'' (for messages that you have deleted). The ''Trash'' folder will be emptied when you log out. In addition to the five folders just described, you might see additional folders like "Mailing Lists" and "Test in the screen shot above. Those have been created by yourself or SWCP, and can be used to organize your email into further categories.

Some of the folders are indicated in bold and carry a number in parentheses to the right of them. This indicates that these folders contain unread messages and the number tells you how many.

To open a folder, you have to click on it once. Its message list will then appear shortly after.

=== The action bar (2) ===
This part of the screen contains a number of icons that allow you to perform different actions, depending on what is being shown in the main part of the window (4). In this example, the 7 icons have the following functions, from left to right:
* ''Refresh Folder:'' checks for new messages in the current folder 
* ''Compose:'' creates a new email message 
* ''Reply:'' creates a new message in reply to the currently selected one; it will be addressed to the sender of the selected message only. 
* ''Reply to all:'' similar to Reply, but the reply will not only be addressed to the sender of the selected message but also to all of its recipients. This makes sense if the message was sent to a group of people and you want all of them to receive your answer. 
* ''Forward Message:'' forwards the currently selected message to another person 
* ''Delete:'' delete the currently selected message(s), that is, move them to Trash 
* ''Print:'' print the currently selected message 

To the right of the action bar, you can see the search field. This field allows you to search all messages in the current folder, much like a search engine on the web. Just enter your search terms and press the Return key. If you are done with your search and want to go back to the original message list, click on the little (X) symbol to the right of the search field.

=== The application bar (3) ===

The three icons at the top right of the screen give you access to different applications which are part of RoundCube. Obviously, this includes the E-Mail component that you have just been looking at. In addition to that, there is also the Address Book which we will describe later. The Personal Settings button gives you access to a number of options that allow you to customize RoundCube according to your needs. Finally, the logout button terminates your RoundCube session. You should always logout after using RoundCube to make sure that nobody else using the same computer will be able to access your emails.

=== The message list (4) ===

This part of the screen is displaying the list of all messages in the folder. To view a message, you have to double-click on it. You can also select a message by clicking on it once and then perform some action on it using one of the buttons in the action bar, e.g. Reply. You can select more than one message by holding the Ctrl key and then clicking on a number of messages in succession. To select a range of messages, select the first message, hold the Shift key and then click on the last message you want to select. Finally, you can also drag-and-drop messages to another folder. Just selected them and then drag them over to one of the folders in the folder list to the left by holding the mouse button. This also provides another way of deleting messages: just drag them into the Trash folder.

You will have noticed that some of the messages in our sample screen were indicated in bold and by a star symbol to the left of them. These are message that have not yet been read by you. A message carrying a little paper clip icon to its right contains an attachment, such as a PDF document or a photo.

== RoundCube Tips ==

=== Using search ===

When entering a search string RoundCube will search in subject and from headers only.

Specific searching is available. Just precede the word to search for with one of the following keywords: from, to, cc, subject or body. Here are a few examples finding emails with 'from' containing 'thomas' and 'subject' containing 'foo'.

from:thomas

subject:foo

=== Preview Pane ===
By default the Preview Pane displays each message as soon as you highlight it in the message list. If you prefer to double-click on the message to view it, do the following:

* In RoundCube click '''Settings'''
* Click '''Mailbox View''' on the left side of the screen
* Uncheck the box next to '''Preview Pane'''
* Click '''Save'''

=== Deleting Messages ===
By default, when you delete a message it is copied to the Trash folder instead of being deleted from the system right away. When you log out, the Trash folder is emptied. Some people run into a problem when the messages they are deleting are so large that they run out of space in the Trash folder. (The error message from RoundCube is, "Unable to move message. Over quota? Trash folder missing?") Here's one solution:
* First, select the messages you want to delete. Use Shift+Click to select a range of messages, or Control+Click to select multiple non-consecutive messages.
* Then hold down the Shift key and press your keyboard's Delete key
This process tells RoundCube to delete the messages immediately, without copying them in the Trash folder first. (It's like the old "delete and expunge" setting in TWIG).

=== Printing Messages ===
To print a message:
* Select the message you want to print from the message list (click it once to highlight it)
* Click the "gear" icon at the top, and you'll get a pull-down menu with several options.
* Select "Print this message".

=== Using the Address Book ===
There are two ways to use the address book. One way is to visit the Address Book from the main page, select a contact, then click the "Compose Mail" icon to send mail to that contact.

The other way is more commonly used. When composing a message, you can type recipient names into the Recipient or CC fields. You can type a whole email address there, or pick an address from your address book. While you type, RoundCube automatically searches for matching names in your address book and displays them. Just type a couple of letters of the person's name and RoundCube will pop up the possible matches.
Press ENTER on the one you want, or click it with the mouse, and then it will be displayed in the recipient box (or CC box if you are adding a CC).

If you don't remember any part of the name you want, type "." and it will display all of your address book entries. That works OK unless you have a very large address book.

If your address book is very large, another option is to open a new browser tab, and log it in to RoundCube and display the address book there. Then you can flip betwee the tabs to see the composition window or the address book window.

=== Folder Management ===
At the bottom of the folder list there is a "gear" icon. Click it to pull down a menu of folder options.
* Compact: If the folder has messages marked for deletion which have not been expunged, this will expunge them.
* Empty: Delete all messages from the folder.
* Manage Folders: From here you can subscribe/unsubscribe to different folders, delete folders, and create new folders.
* Download: This will download a ZIP file containing all the messages from the selected folder to your local machine.

=== Message Templates ===
Roundcube does not yet support "template messages". Here is a workaround that works pretty well though:

# Write your template message and send it to yourself.
# Right-click on the message in your inbox, select Copy To > Drafts.
# Select the message in your Drafts folder. At the top of the message body it will say, "This is a draft message" with an "Edit" link. Click Edit.
# Now customize the message (including the To/Cc list if needed) and send it.

Bonus Tip:
* If you know you will need to do this many times, you can copy the message from your inbox to Drafts several times. Now your Drafts folder will have a handful of copies of the message, and you can quickly pick one to customize and send.

=== Archiving Messages ===
* Log in to roundcube, select a folder
* Click the Gear icon in the lower left under the folder list
* Select [downloadfolder]
* Repeat for each folder you want to archive
The download is a zip file which contains each message in the folder, in .eml format. Most email clients can open .eml files directly.

==See Also==
* [[RoundCube 0.4 Features]] (New version Fall 2010)
* [[RoundCube Distribution List]]
[[Category: Email]]
[[Category: Webmail]]

Use SPF to prevent Gmail bounces

2023-06-08T20:43:26Z

Cheeks:

__NOTOC__
In the first half of 2023, Google began bouncing emails from senders whose domains do not use SPF. Here is how to fix it.

==The Problem==

The technical details can get confusing, but the short explanation is the SPF is a way for you to tell the world what mail servers are authorized to send email using your domain in the sender's email address. In the past, Gmail largely ignored SPF settings, but now they are refusing messages which do not comply.

==The Solution==
The fix is easy, but the particulars depend on where your domain is hosted. If your domain is hosted at SWCP, we can fix this for you quickly (actually, we have supported SPF records in the domains we host for a long time so you're not likely to experience this on a domain hosted here). If your domain's DNS records are hosted elsewhere, such as Wix or Squarespace, you need to make this change at that service. Their tech support should be familiar with this issue and ready to help.

===SPF Record Details for Wix===
If your web site is hosted at Wix, and your email is hosted at SWCP, here is the SPF record you want to add for your domain:

v=spf1 +a include:swcp.com include:wix.com -all

That record specifies that email coming from SWCP's mail servers, OR the Wix web servers, using your domain name in the sender address, is legitimate and should be accepted. Here is an article that covers how to add SPF records to your domain using the Wix service:
https://support.wix.com/en/article/adding-or-updating-spf-records-in-your-wix-account

===SPF Record Details for SquareSpace===
If your web site is hosted at SquareSpace, and your email is hosted at SWCP, here is the SPF record you want to add for your domain:

v=spf1 +a include:swcp.com include:squarespace-mail.com -all

That record specifies that email coming from SWCP's mail servers, OR the Wix web servers, using your domain name in the sender address, is legitimate and should be accepted. Here is an article that covers how to add SPF records to your domain using the SquareSpace service: https://support.powerdmarc.com/support/solutions/articles/60000716316-how-to-set-up-spf-for-squarespace-

===Others?===
If your DNS or web site are hosted elsewhere, contact that company's support to ask about setting up an SPF record for your domain.

==Important Note==
If you use a 3rd party marketing email service, such as Constant Contact or MailChimp, you'll need to add their information to your SPF record as well. Contact them to get the details.

==See Also==
[[Category: Email]]

Use SPF to prevent Gmail bounces

2023-06-08T20:41:18Z

Cheeks: Created page with "In the first half of 2023, Google began bouncing emails from senders whose domains do not use SPF. Here is how to fix it. ==The Problem== The technical details can get confusi..."

In the first half of 2023, Google began bouncing emails from senders whose domains do not use SPF. Here is how to fix it.

==The Problem==

The technical details can get confusing, but the short explanation is the SPF is a way for you to tell the world what mail servers are authorized to send email using your domain in the sender's email address. In the past, Gmail largely ignored SPF settings, but now they are refusing messages which do not comply.

==The Solution==
The fix is easy, but the particulars depend on where your domain is hosted. If your domain is hosted at SWCP, we can fix this for you quickly (actually, we have supported SPF records in the domains we host for a long time so you're not likely to experience this on a domain hosted here). If your domain's DNS records are hosted elsewhere, such as Wix or Squarespace, you need to make this change at that service. Their tech support should be familiar with this issue and ready to help.

===SPF Record Details for Wix===
If your web site is hosted at Wix, and your email is hosted at SWCP, here is the SPF record you want to add for your domain:

v=spf1 +a include:swcp.com include:wix.com -all

That record specifies that email coming from SWCP's mail servers, OR the Wix web servers, using your domain name in the sender address, is legitimate and should be accepted. Here is an article that covers how to add SPF records to your domain using the Wix service:
https://support.wix.com/en/article/adding-or-updating-spf-records-in-your-wix-account

===SPF Record Details for SquareSpace===
If your web site is hosted at SquareSpace, and your email is hosted at SWCP, here is the SPF record you want to add for your domain:

v=spf1 +a include:swcp.com include:squarespace-mail.com -all

That record specifies that email coming from SWCP's mail servers, OR the Wix web servers, using your domain name in the sender address, is legitimate and should be accepted. Here is an article that covers how to add SPF records to your domain using the SquareSpace service: https://support.powerdmarc.com/support/solutions/articles/60000716316-how-to-set-up-spf-for-squarespace-

===Others?===
If your DNS or web site are hosted elsewhere, contact that company's support to ask about setting up an SPF record for your domain.

==Important Note==
If you use a 3rd party marketing email service, such as Constant Contact or MailChimp, you'll need to add their information to your SPF record as well. Contact them to get the details.

==See Also==
[[Category: Email]]

SWCP infrastructure

2022-08-02T23:20:07Z

Cheeks: /* Proxy Cache Server */

SWCP operates a network connecting people and their computers, to our login, web, ftp, mail, and storage servers, and to the Internet at large.
Redundancy is important in providing a reliable network Our physical facilities include an emergency power generator and multiple UPSes. Our connections to the Internet include carrier diversity and and bandwidth redundancy.

==Login Servers==
We provide ssh login service on both bsd and linux servers.

==Mail Farm==
Mail has become one of the most computing resource intensive functions of an ISP. Our email handling facilities have evolved continually. In our current environment we have several groups of machines performing different aspects of this
complex job, including mail acceptance and rejection, scanning for viruses, rating for spaminess, and then
providing for the different delivery methodologies (POP, IMAP, etc).

==Web Farms==
We have clusters of machines providing web service. There are several web servers
serving up customer web pages, with a load balancer front end to distribute access
across the cluster. The web farm also uses application and database servers to
offload computing tasks to dedicated servers for extra speed.

Each web server has access to your website's files and if any one of them crashes
or is bogged down the other machines are available to take over serving your website,
dynamically. Our servers provide a standard LAMP (Linux/Apache/MySQL/PHP) environment
for hosting your websites.

==File Servers==
We have several different file server solutions, using ZFS systems which support snapshots and replication accross many terabytes of storage and backups. In addition to our local storage
redundancy we have a secure commercial offsite storage repository for storage of periodic
encrypted off-site backups.

==Redundant Internet Backhauls==
We have multiple gigabit connections through a variety of Tier-1 providers. We manage our bandwidth to ensure its availability at all times.

==State of the Art Modem Racks==
<wink> We still have a few old analog modem lines in use. How long will they last? No telling!

SWCP infrastructure

2022-08-02T23:19:50Z

Cheeks: /* State of the Art Modem Racks */

SWCP infrastructure

2022-08-02T23:19:11Z

Cheeks: /* Redundant Internet Backhauls */

SWCP operates a network connecting people and their computers, to our login, web, ftp, mail, and storage servers, and to the Internet at large.
Redundancy is important in providing a reliable network Our physical facilities include an emergency power generator and multiple UPSes. Our connections to the Internet include carrier diversity and and bandwidth redundancy.

==Login Servers==
We provide ssh login service on both bsd and linux servers.

==Mail Farm==
Mail has become one of the most computing resource intensive functions of an ISP. Our email handling facilities have evolved continually. In our current environment we have several groups of machines performing different aspects of this
complex job, including mail acceptance and rejection, scanning for viruses, rating for spaminess, and then
providing for the different delivery methodologies (POP, IMAP, etc).

==Web Farms==
We have clusters of machines providing web service. There are several web servers
serving up customer web pages, with a load balancer front end to distribute access
across the cluster. The web farm also uses application and database servers to
offload computing tasks to dedicated servers for extra speed.

Each web server has access to your website's files and if any one of them crashes
or is bogged down the other machines are available to take over serving your website,
dynamically. Our servers provide a standard LAMP (Linux/Apache/MySQL/PHP) environment
for hosting your websites.

==File Servers==
We have several different file server solutions, using ZFS systems which support snapshots and replication accross many terabytes of storage and backups. In addition to our local storage
redundancy we have a secure commercial offsite storage repository for storage of periodic
encrypted off-site backups.

==Redundant Internet Backhauls==
We have multiple gigabit connections through a variety of Tier-1 providers. We manage our bandwidth to ensure its availability at all times.

==State of the Art Modem Racks==
We use Total Control and Lucent Digital modem racks, as well as a few analog modem servers to insure reliable connectivity.

==Proxy Cache Server==
To enhance accessibility of popular sites, we provide a [[proxy cache server]].

SWCP infrastructure

2022-08-02T23:18:21Z

Cheeks: /* File Servers */

SWCP operates a network connecting people and their computers, to our login, web, ftp, mail, and storage servers, and to the Internet at large.
Redundancy is important in providing a reliable network Our physical facilities include an emergency power generator and multiple UPSes. Our connections to the Internet include carrier diversity and and bandwidth redundancy.

==Login Servers==
We provide ssh login service on both bsd and linux servers.

==Mail Farm==
Mail has become one of the most computing resource intensive functions of an ISP. Our email handling facilities have evolved continually. In our current environment we have several groups of machines performing different aspects of this
complex job, including mail acceptance and rejection, scanning for viruses, rating for spaminess, and then
providing for the different delivery methodologies (POP, IMAP, etc).

==Web Farms==
We have clusters of machines providing web service. There are several web servers
serving up customer web pages, with a load balancer front end to distribute access
across the cluster. The web farm also uses application and database servers to
offload computing tasks to dedicated servers for extra speed.

Each web server has access to your website's files and if any one of them crashes
or is bogged down the other machines are available to take over serving your website,
dynamically. Our servers provide a standard LAMP (Linux/Apache/MySQL/PHP) environment
for hosting your websites.

==File Servers==
We have several different file server solutions, using ZFS systems which support snapshots and replication accross many terabytes of storage and backups. In addition to our local storage
redundancy we have a secure commercial offsite storage repository for storage of periodic
encrypted off-site backups.

==Redundant Internet Backhauls==
We have several OC3s through Time Warner, Sprint, and Qwest in order to provide high availability Internet access. Our fiber connections are carrier diverse and our network providers are both diverse and redundant. We manage our bandwidth to ensure its availability at all times.

==State of the Art Modem Racks==
We use Total Control and Lucent Digital modem racks, as well as a few analog modem servers to insure reliable connectivity.

==Proxy Cache Server==
To enhance accessibility of popular sites, we provide a [[proxy cache server]].

SWCP infrastructure

2022-08-02T23:16:41Z

Cheeks: /* Web Farms */

SWCP operates a network connecting people and their computers, to our login, web, ftp, mail, and storage servers, and to the Internet at large.
Redundancy is important in providing a reliable network Our physical facilities include an emergency power generator and multiple UPSes. Our connections to the Internet include carrier diversity and and bandwidth redundancy.

==Login Servers==
We provide ssh login service on both bsd and linux servers.

==Mail Farm==
Mail has become one of the most computing resource intensive functions of an ISP. Our email handling facilities have evolved continually. In our current environment we have several groups of machines performing different aspects of this
complex job, including mail acceptance and rejection, scanning for viruses, rating for spaminess, and then
providing for the different delivery methodologies (POP, IMAP, etc).

==Web Farms==
We have clusters of machines providing web service. There are several web servers
serving up customer web pages, with a load balancer front end to distribute access
across the cluster. The web farm also uses application and database servers to
offload computing tasks to dedicated servers for extra speed.

Each web server has access to your website's files and if any one of them crashes
or is bogged down the other machines are available to take over serving your website,
dynamically. Our servers provide a standard LAMP (Linux/Apache/MySQL/PHP) environment
for hosting your websites.

==File Servers==
We have several different file server solutions, including multiple Network Appliances, and Linux and FreeBSD file servers providing many terabytes of storage and backups. In addition to our local storage redundancy we have a secure commercial offsite storage repository.

==Redundant Internet Backhauls==
We have several OC3s through Time Warner, Sprint, and Qwest in order to provide high availability Internet access. Our fiber connections are carrier diverse and our network providers are both diverse and redundant. We manage our bandwidth to ensure its availability at all times.

==State of the Art Modem Racks==
We use Total Control and Lucent Digital modem racks, as well as a few analog modem servers to insure reliable connectivity.

==Proxy Cache Server==
To enhance accessibility of popular sites, we provide a [[proxy cache server]].

SWCP infrastructure

2022-08-02T23:14:02Z

Cheeks: /* Login Servers */

SWCP operates a network connecting people and their computers, to our login, web, ftp, mail, and storage servers, and to the Internet at large.
Redundancy is important in providing a reliable network Our physical facilities include an emergency power generator and multiple UPSes. Our connections to the Internet include carrier diversity and and bandwidth redundancy.

==Login Servers==
We provide ssh login service on both bsd and linux servers.

==Mail Farm==
Mail has become one of the most computing resource intensive functions of an ISP. Our email handling facilities have evolved continually. In our current environment we have several groups of machines performing different aspects of this
complex job, including mail acceptance and rejection, scanning for viruses, rating for spaminess, and then
providing for the different delivery methodologies (POP, IMAP, etc).

==Web Farms==
We have two different sets of machines providing web service. Each group is a collection of
four to five dedicated web servers with a load balancer front end. Each web server has
access to your website's files and if any one of them crashes or is bogged down the other
machines are available to take over serving your website, dynamically. Our servers provide a generic Unix/Apache/MySQL environment for hosting your websites.

We have two different farms to provide both stable and cutting edge software depending on
your needs. We also support extant obsolete Microsoft FrontPage extension websites separately, and only for a limited time longer.

==File Servers==
We have several different file server solutions, including multiple Network Appliances, and Linux and FreeBSD file servers providing many terabytes of storage and backups. In addition to our local storage redundancy we have a secure commercial offsite storage repository.

==Redundant Internet Backhauls==
We have several OC3s through Time Warner, Sprint, and Qwest in order to provide high availability Internet access. Our fiber connections are carrier diverse and our network providers are both diverse and redundant. We manage our bandwidth to ensure its availability at all times.

==State of the Art Modem Racks==
We use Total Control and Lucent Digital modem racks, as well as a few analog modem servers to insure reliable connectivity.

==Proxy Cache Server==
To enhance accessibility of popular sites, we provide a [[proxy cache server]].

Configure iPhone or iPad for SWCP Email

2022-03-09T22:22:14Z

Cheeks: /* Removing a non-functional email account */

Updated for iOS 14 (on April 12 2021). Please email [mailto:help@swcp.com?subject=Please%20Update%20https://members.swcp.com/wiki/Configure_iPhone_or_iPad_for_SWCP_Email help@swcp.com] if this article needs to be updated.

=Email Account Setup Prerequisites=
There are several ways configure your iPhone for email. The following describes the method that will work ''best'' with SWCP's mail servers.

==Use IMAP, not POP==
In almost every scenario, IMAP is considered superior to POP. If you will be accessing your mailbox from multiple locations at the same time, IMAP will work best. Remember that if your desktop computer is configured to check for mail every 10 minutes, and you are out and about checking mail on your iphone, there will be times when your phone and computer try to hit the mailbox at the same time. IMAP supports this, but POP does not.

SWCP does not support email over Exchange.

=How to add your SWCP email account=

# Open the "Settings" app on your iPhone or iPad
# Go to "Mail"
# Tap on "Accounts"
# Tap on "Add Account"
# Tap on "Other"
# Then tap on "Add Mail Account"
## Fill in the "Name". This is the same name others will see when you send them an email.
## Fill in the "Email". This is the same email others will reply to when you send them an email.
## Fill in the "Password". If you do not know your email password. Please [https://www.swcp.com/support-services/ contact our technical support team].
## Fill in the "Description". We recommend using your full email address as the description.
# Once you fill those four fields, hit "Next"

You will then see additional fields that will need to be filled in.

{{warning|1=The Username and Password fields are '''NOT''' optional, even if iOS claims it is}}

# Make sure "IMAP" is selected at the top of the screen
# The Name, Email, and Description should appear as you entered them on the previous page, only change them if there are any typos
# Under "INCOMING MAIL SERVER"
## Set the "Host Name" to: '''mail.swcp.com'''
## Enter your SWCP username in the User Name field (this name may be different from your email address)
## Your SWCP password should already be entered, from the previous page
# Under "OUTGOING MAIL SERVER"
## Set the "Host Name" to: '''mail.swcp.com'''
## Enter your SWCP username in the User Name field (this name may be different from your email address)
## You need to enter the password again here
# Tap "Next", and on the next screen tap "Save"

Now you can leave the Settings app and open the Mail app to use this account.

=Testing your email account=
The easiest way to see if email flows both in and out is to send yourself an email from the SWCP account to the SWCP account.

If your receive your test email, then your email is functioning correctly.

=How to adjust the Advanced Settings=
For almost all email accounts, this is not necessary to do.
However, if you accidentally adjusted something in the "Advanced Settings" you might want to know how to change the settings back to a working state.

* Open the "Settings" app on your iPhone or iPad
* Go to "Password & Accounts" on the left-hand side
* Tap on your SWCP account
* Tap on "Account"
* Tap on "SMTP"

Now you can adjust the ''outgoing'' mail server advanced settings.

* Make sure that "Server" at the top is enabled
* "Host Name" needs to be set to: '''mail.swcp.com'''
* Make sure username is spelt correctly and does not have an ''@'' sign or anyhthing else after the ''@'' sign
* Make sure you have the correct password as well
* Turn on the "Use SSL" button
* Make sure that "Authentication" is set to '''Password'''
* Make sure that "Server Port" is set to '''587'''
* Tap on "Done" once complete.

* Tap on "Advanced" (at the bottom)

Now you can adjust the ''incoming'' mail server advanced settings.

* "Drafts Mailbox" can be set to '''Drafts'''
* "Sent Mailbox" can be set to '''Sent'''
* "Deleted Mailbox" can be set to '''Trash'''
* "Archive Mailbox" can be set to '''Archive''' (if one exists)
* Set "Move Discarded Messages Into" to '''Deleted Mailbox'''
* "Remove" can be set to '''After one week'''
* Turn on the "Use SSL" button
* "Authentication" needs to be set to '''Password'''
* "IMAP Path Prefix" needs to be '''empty'''
* "Server Port" needs to be set to '''993'''

==Removing a non-functional email account==
Please ignore this section if you are adding an SWCP email account for the first time.

If there are issues with your SWCP email account such as: Inbox has old email, cannot send email, or getting a invalid password error that doesn't go away. Then you might want to consider removing your SWCP email account so you can then re-add the SWCP email account. Continue reading.

===Verify if you can safely remove the email account===

If you are planning on removing your SWCP email account from your iPhone or iPad. Please check to see if the account was setup as IMAP or POP. IMAP is safe to remove since IMAP will continusly syncronize with the email server, thus you can restore your email easily. However, POP will typically default to remove email on the email server after a certain amount of days. So you might not be able to completely restore your POP email account without manually backing up these emails.

* Open the "Settings" app on your iPhone or iPad
* Go to: "Mail"
* Select: "Accounts"
* Click on your SWCP email account
* Then select "Account"
* Above the "Account" line, there will be mention of either IMAP or POP

If the email account shows IMAP, you can remove the email account from your iPhone or iPad without loss of data.

If the email account shows it's using POP, then you need to backup the email before removing the email account. At the time of writing there are no backup utilities to automatically do this for you. You might have to add a second email account that uses IMAP and move the emails into that IMAP email account.

===How to remove the SWCP IMAP email account===

If you have not already verified that the SWCP email account is an IMAP email account and NOT a POP email account, then please read [[#Verify if you can safely remove the email account|Verify if you can safely remove the email account]] above.

* Open the "Settings" app on your iPhone or iPad
* Go to: "Mail"
* Select: "Accounts"
* Click on your SWCP email account
* At the bottom, select: "Delete Account"

Now you have removed your SWCP email account.

If you want to re-add the SWCP IMAP email account, please read [[#How to add your SWCP email account|How to add your SWCP email account]] below.

=Deleting Messages=
Determining how messages will be deleted is important. It's irritating to read email on your iPhone, then go back to the office and have to wade through the same messages. You want to be able to delete messages from the iPhone and have your desktop email program recognize those deletions. This is an area where IMAP is essential. In the "Advanced Settings" for your iPhone mail account, you have these options to affect how messages are deleted:

* "Deleted mailbox" - can be "On My iPhone" or a named folder on the server. If it's "On My iPhone" the deleted messages get copied to a folder named Trash on your phone. DO NOT USE THIS OPTION.

* If "Deleted Mailbox" is set to a folder on the server (e.g. "Deleted Messages") then when you delete a message from any folder it gets COPIED to the "Deleted Messages" folder, *and* marked as "deleted" in the original folder.

When you go into the INBOX or other folders with your desktop client or webmail, the messages you deleted from the iphone will still be visible there, but marked "deleted". If you "Empty Trash" they'll get really deleted from the folder. A copy of them will still be in the "Deleted Messages" folder.

There's one more important setting on the iPhone: the "Remove" setting. It can be "After one day", "week", or "month". This controls how long the iPhone will leave messages in the "Deleted Messages" folder. "1 week" is a good setting. Every time you check mail from the iPhone, it nukes messages older than a week from the "Deleted Messages" folder. If you get a lot of large email attachments and delete from the iPhone, this could be a problem because of the disk space needed for the "Deleted Messages" folder. You could use a shorter period (1 day), or buy more disk space, or just resist the urge to delete those messages from the iphone.

Oh, one more thing: in order to select the "Deleted Messages" folder in the advanced settings, the folder had to be created ahead of time. You can create the folder in webmail, or using the IMAP client on your desktop computer (Thunderbird, mail.app, Outlook, etc.)

=The IMAP Folder Problem=

The IMAP server keeps a list of your "subscribed" folders. That is, files in your directory which are mail folders. That way most IMAP clients (like Outlook or Thunderbird or RoundCube webmail) know which files in your home directory to display as mail folders, and they ignore the rest. However, the iPhone ignores this subscription list and displays ALL the files it finds. This is irritating for a couple of different reasons, but there doesn't seem to be any fix for it, as of iPhone OS 3.x. Perhaps they'll fix it in <s>4.0 nope</s> <s>5.0 nope</s> <s>6.0 nope</s> <s>7.0 nope</s> <s>8.0 nope</s>

For some people this is no big deal. You just see a few extra files and you can mentally ignore them. For others, it's a big problem. For example, if your home directory also has a large web site stored, it might actually prevent the iPhone from being able to function, because it times out waiting for the huge (and useless!) file list to transfer.

Here are a couple of workarounds:
* '''[SWCP Only] Switch to maildir''' - at SWCP this issue does not affect accounts that are on our newer mail servers which use the "maildir" format for storing messages outside the user's home directory.
** '''NB''': If we change an account to maildir to fix this problem, you then need to delete the account from the device and re-add it. That seems to be the only way to get it to "forget" all those bogus folders that it saw.
* '''Only use INBOX''' - to do this, set Advanced -> Incoming Settings -> IMAP Path Prefix to the word "INBOX" (all capitals, no punctuation). Now when you access mail in this account, it will only show you your INBOX, and not any other IMAP folders that you might have. If you primarily use your phone to look at incoming mail and don't mind waiting until you are at your main computer to file messages into folders, this might work for you. But it means you can't access old messages that you previously filed into folders.
* '''Put folders in a subdirectory''' - to do this, create a subdirectory in your home directory on the SWCP server called "mail". In that directory create symbolic links to your folders one level up. Set the IMAP Path Prefix on the iPhone to the word "mail". Now the iPhone will only see those folders. (This won't disturb other IMAP clients you may be using such as Thunderbird, Outlook, or webmail). '''If you want to do this, please ask help@swcp.com to set it up for you.''' We'll take care of creating the directory and required links.

=See Also=
* [[Using Multiple Identities in iPhone Mail]]
* [[Configure K-9 on Android for SWCP Email]]
[[Category: Email]]
[[Category: iPhone]]

Configure iPhone or iPad for SWCP Email

2022-03-09T22:21:53Z

Cheeks:

Updated for iOS 14 (on April 12 2021). Please email [mailto:help@swcp.com?subject=Please%20Update%20https://members.swcp.com/wiki/Configure_iPhone_or_iPad_for_SWCP_Email help@swcp.com] if this article needs to be updated.

=Email Account Setup Prerequisites=
There are several ways configure your iPhone for email. The following describes the method that will work ''best'' with SWCP's mail servers.

==Use IMAP, not POP==
In almost every scenario, IMAP is considered superior to POP. If you will be accessing your mailbox from multiple locations at the same time, IMAP will work best. Remember that if your desktop computer is configured to check for mail every 10 minutes, and you are out and about checking mail on your iphone, there will be times when your phone and computer try to hit the mailbox at the same time. IMAP supports this, but POP does not.

SWCP does not support email over Exchange.

==Removing a non-functional email account==
Please ignore this section if you are adding an SWCP email account for the first time.

If there are issues with your SWCP email account such as: Inbox has old email, cannot send email, or getting a invalid password error that doesn't go away. Then you might want to consider removing your SWCP email account so you can then re-add the SWCP email account. Continue reading.

=How to add your SWCP email account=

# Open the "Settings" app on your iPhone or iPad
# Go to "Mail"
# Tap on "Accounts"
# Tap on "Add Account"
# Tap on "Other"
# Then tap on "Add Mail Account"
## Fill in the "Name". This is the same name others will see when you send them an email.
## Fill in the "Email". This is the same email others will reply to when you send them an email.
## Fill in the "Password". If you do not know your email password. Please [https://www.swcp.com/support-services/ contact our technical support team].
## Fill in the "Description". We recommend using your full email address as the description.
# Once you fill those four fields, hit "Next"

You will then see additional fields that will need to be filled in.

{{warning|1=The Username and Password fields are '''NOT''' optional, even if iOS claims it is}}

# Make sure "IMAP" is selected at the top of the screen
# The Name, Email, and Description should appear as you entered them on the previous page, only change them if there are any typos
# Under "INCOMING MAIL SERVER"
## Set the "Host Name" to: '''mail.swcp.com'''
## Enter your SWCP username in the User Name field (this name may be different from your email address)
## Your SWCP password should already be entered, from the previous page
# Under "OUTGOING MAIL SERVER"
## Set the "Host Name" to: '''mail.swcp.com'''
## Enter your SWCP username in the User Name field (this name may be different from your email address)
## You need to enter the password again here
# Tap "Next", and on the next screen tap "Save"

Now you can leave the Settings app and open the Mail app to use this account.

=Testing your email account=
The easiest way to see if email flows both in and out is to send yourself an email from the SWCP account to the SWCP account.

If your receive your test email, then your email is functioning correctly.

=How to adjust the Advanced Settings=
For almost all email accounts, this is not necessary to do.
However, if you accidentally adjusted something in the "Advanced Settings" you might want to know how to change the settings back to a working state.

* Open the "Settings" app on your iPhone or iPad
* Go to "Password & Accounts" on the left-hand side
* Tap on your SWCP account
* Tap on "Account"
* Tap on "SMTP"

Now you can adjust the ''outgoing'' mail server advanced settings.

* Make sure that "Server" at the top is enabled
* "Host Name" needs to be set to: '''mail.swcp.com'''
* Make sure username is spelt correctly and does not have an ''@'' sign or anyhthing else after the ''@'' sign
* Make sure you have the correct password as well
* Turn on the "Use SSL" button
* Make sure that "Authentication" is set to '''Password'''
* Make sure that "Server Port" is set to '''587'''
* Tap on "Done" once complete.

* Tap on "Advanced" (at the bottom)

Now you can adjust the ''incoming'' mail server advanced settings.

* "Drafts Mailbox" can be set to '''Drafts'''
* "Sent Mailbox" can be set to '''Sent'''
* "Deleted Mailbox" can be set to '''Trash'''
* "Archive Mailbox" can be set to '''Archive''' (if one exists)
* Set "Move Discarded Messages Into" to '''Deleted Mailbox'''
* "Remove" can be set to '''After one week'''
* Turn on the "Use SSL" button
* "Authentication" needs to be set to '''Password'''
* "IMAP Path Prefix" needs to be '''empty'''
* "Server Port" needs to be set to '''993'''

==Removing a non-functional email account==
Please ignore this section if you are adding an SWCP email account for the first time.

If there are issues with your SWCP email account such as: Inbox has old email, cannot send email, or getting a invalid password error that doesn't go away. Then you might want to consider removing your SWCP email account so you can then re-add the SWCP email account. Continue reading.

===Verify if you can safely remove the email account===

If you are planning on removing your SWCP email account from your iPhone or iPad. Please check to see if the account was setup as IMAP or POP. IMAP is safe to remove since IMAP will continusly syncronize with the email server, thus you can restore your email easily. However, POP will typically default to remove email on the email server after a certain amount of days. So you might not be able to completely restore your POP email account without manually backing up these emails.

* Open the "Settings" app on your iPhone or iPad
* Go to: "Mail"
* Select: "Accounts"
* Click on your SWCP email account
* Then select "Account"
* Above the "Account" line, there will be mention of either IMAP or POP

If the email account shows IMAP, you can remove the email account from your iPhone or iPad without loss of data.

If the email account shows it's using POP, then you need to backup the email before removing the email account. At the time of writing there are no backup utilities to automatically do this for you. You might have to add a second email account that uses IMAP and move the emails into that IMAP email account.

===How to remove the SWCP IMAP email account===

If you have not already verified that the SWCP email account is an IMAP email account and NOT a POP email account, then please read [[#Verify if you can safely remove the email account|Verify if you can safely remove the email account]] above.

* Open the "Settings" app on your iPhone or iPad
* Go to: "Mail"
* Select: "Accounts"
* Click on your SWCP email account
* At the bottom, select: "Delete Account"

Now you have removed your SWCP email account.

If you want to re-add the SWCP IMAP email account, please read [[#How to add your SWCP email account|How to add your SWCP email account]] below.

=Deleting Messages=
Determining how messages will be deleted is important. It's irritating to read email on your iPhone, then go back to the office and have to wade through the same messages. You want to be able to delete messages from the iPhone and have your desktop email program recognize those deletions. This is an area where IMAP is essential. In the "Advanced Settings" for your iPhone mail account, you have these options to affect how messages are deleted:

* "Deleted mailbox" - can be "On My iPhone" or a named folder on the server. If it's "On My iPhone" the deleted messages get copied to a folder named Trash on your phone. DO NOT USE THIS OPTION.

* If "Deleted Mailbox" is set to a folder on the server (e.g. "Deleted Messages") then when you delete a message from any folder it gets COPIED to the "Deleted Messages" folder, *and* marked as "deleted" in the original folder.

When you go into the INBOX or other folders with your desktop client or webmail, the messages you deleted from the iphone will still be visible there, but marked "deleted". If you "Empty Trash" they'll get really deleted from the folder. A copy of them will still be in the "Deleted Messages" folder.

There's one more important setting on the iPhone: the "Remove" setting. It can be "After one day", "week", or "month". This controls how long the iPhone will leave messages in the "Deleted Messages" folder. "1 week" is a good setting. Every time you check mail from the iPhone, it nukes messages older than a week from the "Deleted Messages" folder. If you get a lot of large email attachments and delete from the iPhone, this could be a problem because of the disk space needed for the "Deleted Messages" folder. You could use a shorter period (1 day), or buy more disk space, or just resist the urge to delete those messages from the iphone.

Oh, one more thing: in order to select the "Deleted Messages" folder in the advanced settings, the folder had to be created ahead of time. You can create the folder in webmail, or using the IMAP client on your desktop computer (Thunderbird, mail.app, Outlook, etc.)

=The IMAP Folder Problem=

The IMAP server keeps a list of your "subscribed" folders. That is, files in your directory which are mail folders. That way most IMAP clients (like Outlook or Thunderbird or RoundCube webmail) know which files in your home directory to display as mail folders, and they ignore the rest. However, the iPhone ignores this subscription list and displays ALL the files it finds. This is irritating for a couple of different reasons, but there doesn't seem to be any fix for it, as of iPhone OS 3.x. Perhaps they'll fix it in <s>4.0 nope</s> <s>5.0 nope</s> <s>6.0 nope</s> <s>7.0 nope</s> <s>8.0 nope</s>

For some people this is no big deal. You just see a few extra files and you can mentally ignore them. For others, it's a big problem. For example, if your home directory also has a large web site stored, it might actually prevent the iPhone from being able to function, because it times out waiting for the huge (and useless!) file list to transfer.

Here are a couple of workarounds:
* '''[SWCP Only] Switch to maildir''' - at SWCP this issue does not affect accounts that are on our newer mail servers which use the "maildir" format for storing messages outside the user's home directory.
** '''NB''': If we change an account to maildir to fix this problem, you then need to delete the account from the device and re-add it. That seems to be the only way to get it to "forget" all those bogus folders that it saw.
* '''Only use INBOX''' - to do this, set Advanced -> Incoming Settings -> IMAP Path Prefix to the word "INBOX" (all capitals, no punctuation). Now when you access mail in this account, it will only show you your INBOX, and not any other IMAP folders that you might have. If you primarily use your phone to look at incoming mail and don't mind waiting until you are at your main computer to file messages into folders, this might work for you. But it means you can't access old messages that you previously filed into folders.
* '''Put folders in a subdirectory''' - to do this, create a subdirectory in your home directory on the SWCP server called "mail". In that directory create symbolic links to your folders one level up. Set the IMAP Path Prefix on the iPhone to the word "mail". Now the iPhone will only see those folders. (This won't disturb other IMAP clients you may be using such as Thunderbird, Outlook, or webmail). '''If you want to do this, please ask help@swcp.com to set it up for you.''' We'll take care of creating the directory and required links.

=See Also=
* [[Using Multiple Identities in iPhone Mail]]
* [[Configure K-9 on Android for SWCP Email]]
[[Category: Email]]
[[Category: iPhone]]

Using MySQL Workbench with an SSH Tunnel

2021-04-09T23:53:55Z

Cheeks: Created page with "==MySQL access via SSH Tunnel== MySQL Workbench is a MySQL client program that runs on your Mac/Windows/Linux desktop. It can connect directly to mysql on port 3306. However, ..."

==MySQL access via SSH Tunnel==

MySQL Workbench is a MySQL client program that runs on your Mac/Windows/Linux desktop. It can connect directly to mysql on port 3306. However, the SWCP MySQL servers are firewalled, so customers on other networks can't connect to it directly.

MySQL Workbench and Sequel Pro (Mac only I think) support SSH Tunnels.

'''NOTE: The user needs shell access enabled for this to work.'''

Here's how to set it up:

===MySQL Workbench===
* Create a new connection profile.
* Set the Connection Method to "Standard TCP/IP over SSH"
* Set the SSH hostname to '''login.swcp.com'''
* Set the SSH Username to your shell account login name
* Set the MySQL Hostname to the hostname for your database. If your database is called "bobwork2", the hostname will be '''bobwork2.sqldb.swcp.com'''.
* Set the Username to your database username (note: not your shell login name)

When you use the profile, you will first get a prompt for the shell account password, and then for the database password. Note that there are two different usernames and passwords in this process.

===Sequel Pro===
This is another MySQL interface. It's only for the Mac. Get it from http://www.sequelpro.com.

* In the Connection Details, select the SSH tab
* Set the MySQL Host to the hostname for your database. If your database is called "bobwork2", the hostname will be '''bobwork2.sqldb.swcp.com'''.
* Enter your database name, username, and password.
* Set the SSH Host to '''login.swcp.com'''
* Set the SSH User to your shell username. Enter the matching password in the SSH Password field.

Hit the "Test Connection" button to test your settings. If the connection fails, the "Show Details" button will give you some information that you can cut-n-paste and send to help@swcp.com. After you get it working, click "Add to Favorites" to save the settings.

==See Also==
[[Category: MySQL]]

KB SSH

2021-04-09T23:53:40Z

Cheeks:

# [[KB 130]] How Do I Download, Install and Use PuTTY?
# [[KB 139]] How do I uninstall Putty?
# [[KB 395]] X Forwarding not working right with FreeBSD
# [[KB 133]] What's this about telnet going away? Being replaced by SSH?
# [[KB 225]] I can't get MacSSH to work with your system, why?
# [[KB 458]] Why does my Mac Mail on Mac OSX keep asking for my Password and failing?
# [[KB 134]] How do I get NiftyTelnet 1.1 R3 to use SSH?
# [[KB 282]] SWCP Direct customer SSH sessions die
# [[KB 129]] Why can't I login with ssh? I'm running Unix.
# [[Using MySQL Workbench with an SSH Tunnel]]

[[https://members.swcp.com/wiki/index.php?title=Knowledge_Base Back]]

Outlook 365 on Windows 10 and up

2021-01-05T00:01:31Z

Cheeks: Created page with "The best way to configure Outlook on Windows 10 is through the Control Panel. The following is for Outlook 2019 (aka Outlook 365) and other versions should be similar. # In Win..."

The best way to configure Outlook on Windows 10 is through the Control Panel. The following is for Outlook 2019 (aka Outlook 365) and other versions should be similar.

# In Windows 10, click on the Start menu and type “Control” to find the Control Panel App, and click on it from the search results
# Search for "mail" in the Control Panel search box in the upper right corner. Click on Mail (Microsoft Outlook...).
# Click the "Email Accounts..." button then click "New"
# On the "Add Account" screen, select "Manual setup or additional server types" and then press "Next"
# Click the "POP or IMAP" button, then click "Next"
# On the "Add Account" screen, fill in these items:
#* Your Name (e.g. Jane Public)
#* Email Address - If you have your own domain, use that address here, otherwise your username@swcp.com email address.
#* Set Account Type to "IMAP"
#* Incoming Mail Server: mail.swcp.com
#* Outgoing Mail Server: mail.swcp.com
#* User Name: Your SWCP username
#* Password: your SWCP mailbox password
#* Make sure the “Require login using Secure Password…” box is '''NOT CHECKED'''
#* Click the "More Settings" button, then the "Outgoing Server" tab
#* Click the “My outgoing server requires authentication” box
#* Click the “Use same settings as my incoming mail server” button (it should already be selected).
#* Click the Advanced tab
#* Under "Incoming Server", set "Use the following type of encrypted connection" to "SSL/TLS" and set the port number to 993
#* Under "Outgoing Server", set "Use the following type of encrypted connection" to "SSL/TLS" and set the port number to 465. (Double-check that the port number stays at 465 before hitting OK … sometimes it will change).
#* Click "OK", then "Next"
#* It should do a test, which will hopefully be successful. Then click "Close" on the test window and "Finish" on the "Add Account" window.

Now you can start Outlook and use this account!
==See Also==
[[Category: Email]]

KB Email-3

2021-01-04T23:52:21Z

Cheeks: /* See Also */

Configure Thunderbird on Linux

2021-01-04T19:32:59Z

Cheeks: moved Configure Thunderbird on Linux to Configure Thunderbird on Linux, MacOSX or Windows

#REDIRECT [[Configure Thunderbird on Linux, MacOSX or Windows]]

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T19:32:59Z

Cheeks: moved Configure Thunderbird on Linux to Configure Thunderbird on Linux, MacOSX or Windows

==Thunderbird on Fedora 20 Linux==
This information kindly submitted by one of our users.

This applies specifically to Thunderbird on a Fedora 20 system, but should be applicable to most Linux desktop environments.

# Start Thunderbird and tell it to add a new account
#* If you select POP3, it should default to SSL/TLS on port 995 with password authentication.
#* If you select IMAP it should default to SSL/TLS on port 993 with password authentication.
# Outgoing mail should work with default settings, no special set-up needed.

The Thunderbird default account settings for POP leave the mail on the server, and some users may want to reset that option to load the mail to their home machine and remove from the server. With IMAP, all mail is left on the server (best choice if you use multiple devices to access your mail).

All done!

==Thunderbird on Windows or Mac OS X==

# Start Thunderbird, go to Tools > Account Settings. Click Account Actions, then Add Mail Account...
# Fill in the first 3 fields with your name, email address, and password. If you have an email address with your own domain name, use it here. If not, use your @swcp.com address.
# Click the "Configure manually" button, and fill in these settings:
#* Leave Protocol set to IMAP for Incoming and SMTP for Outgoing
#* Change the Server to "mail.swcp.com" for under both Incoming and Outgoing
#* Set SSL to "SSL/TLS" under both Incoming and Outgoing
#* Set Authentication to "Normal Password" for both Incoming and Outgoing
#* Set the Username to your SWCP Username
#* Click the "Re-Test" button to test the settings.
# Click Done

[[Category: Email]]

KB Email-3

2021-01-04T19:32:35Z

Cheeks: /* See Also */

==SWCP Email Server Settings==

This article contains the info you need to set up any email client to work with the SWCP mail servers.

* Outgoing mail server: mail.swcp.com
** Authenticated SMTP Port: 465
** Use SSL with Authenticated SMTP: Yes
*** or for TLS (mac mail tends to like this better)
**** Authenticated SMTP Port: 587
**** Use TLS with Authenticated SMTP: Yes
** What about good old port 25?
*** Port 25 works only under certain conditions, and is no longer intended for email client interaction. It is best to use Authenticated SMTP which should always work.

* Incoming mail server: mail.swcp.com
** Incoming Protocols: IMAP or POP. Again, we recommend you ONLY use the SSL versions of these services.
*** SSL IMAP Port: 993 '''(Recommended)'''
*** Standard (insecure) IMAP port: 143
*** SSL POP Port: 995
*** Standard (insecure) POP Port: 110

== See Also ==

* [[Authenticated SMTP]] - includes instructions for a variety of email software
* [[KB Email-1|Outlook 2003 with Auth SMTP and IMAP SSL]]
* [[KB Email-2|Outlook 2007 with Auth SMTP and IMAP SSL]]
* [[Apple Mail with Auth SMTP and IMAP SSL]]
* [[Configure iPhone or iPad for SWCP Email]]
* [[Configure K-9 on Android for SWCP Email]]
* [[Configure Thunderbird on Linux, MacOSX or Windows]]
* [[Configure Sendmail Client for Auth SMTP]] - Only useful if you run your own sendmail server
* [[Maximum Email Message Sizes]] - for different ISPs

[[Category: Email]]
[[Category: Webmail]]

KB Email-3

2021-01-04T19:31:52Z

Cheeks: /* See Also */

==SWCP Email Server Settings==

This article contains the info you need to set up any email client to work with the SWCP mail servers.

* Outgoing mail server: mail.swcp.com
** Authenticated SMTP Port: 465
** Use SSL with Authenticated SMTP: Yes
*** or for TLS (mac mail tends to like this better)
**** Authenticated SMTP Port: 587
**** Use TLS with Authenticated SMTP: Yes
** What about good old port 25?
*** Port 25 works only under certain conditions, and is no longer intended for email client interaction. It is best to use Authenticated SMTP which should always work.

* Incoming mail server: mail.swcp.com
** Incoming Protocols: IMAP or POP. Again, we recommend you ONLY use the SSL versions of these services.
*** SSL IMAP Port: 993 '''(Recommended)'''
*** Standard (insecure) IMAP port: 143
*** SSL POP Port: 995
*** Standard (insecure) POP Port: 110

== See Also ==

* [[Authenticated SMTP]] - includes instructions for a variety of email software
* [[KB Email-1|Outlook 2003 with Auth SMTP and IMAP SSL]]
* [[KB Email-2|Outlook 2007 with Auth SMTP and IMAP SSL]]
* [[Apple Mail with Auth SMTP and IMAP SSL]]
* [[Configure iPhone or iPad for SWCP Email]]
* [[Configure K-9 on Android for SWCP Email]]
* [[Configure Thunderbird on Linux, MacOSX and Windows]]
* [[Configure Sendmail Client for Auth SMTP]] - Only useful if you run your own sendmail server
* [[Maximum Email Message Sizes]] - for different ISPs

[[Category: Email]]
[[Category: Webmail]]

Configure iPhone or iPad for SWCP Email

2021-01-04T19:22:52Z

Cheeks: /* How to add your SWCP email account */

=Email Account Setup Prerequisites=
There are several ways configure your iPhone for email. The following describes the method that will work ''best'' with SWCP's mail servers.

==Use IMAP, not POP==
In almost every scenario, IMAP is considered superior to POP. If you will be accessing your mailbox from multiple locations at the same time, IMAP will work best. Remember that if your desktop computer is configured to check for mail every 10 minutes, and you are out and about checking mail on your iphone, there will be times when your phone and computer try to hit the mailbox at the same time. IMAP supports this, but POP does not.

At the time of writing, SWCP does not support email over Exchange.

==Removing a non-functional email account==
Please ignore this section if you are adding an SWCP email account for the first time.

If there are issues with your SWCP email account such as: Inbox has old email, cannot send email, or getting a invalid password error that doesn't go away. You might consider removing your SWCP email account so you can re-add the account.

If you are planning on removing your SWCP email account from your iPhone or iPad. Please check to see if the account was setup as IMAP or POP. IMAP is safe to remove since IMAP will continusly syncronize with the email server, thus you can restore your email easily. However, POP will typically default to remove email on the email server after a certain amount of days. So you might not be able to completely restore your POP email account without manually backing up these emails.

* Open the "Settings" app on your iPhone or iPad
* Go to: "Password & Accounts"
* Click on your SWCP email account
* Above the "Account" line, there will be mention of either IMAP or POP

If the email account shows IMAP, you can remove the email account from your iPhone or iPad without loss of data.

If the email account shows it's using POP, then you need to backup the email before removing the email account. At the time of writing there are no backup utilities to automatically do this for you. You might have to add a second email account that uses IMAP and move the emails into that IMAP email account.

=How to add your SWCP email account=
Here are the instructions on how to add your SWCP email account to your iPhone or iPad.

* Open the "Settings" app on your iPhone or iPad
* Go to "Mail" and then "Accounts"
* Tap on "Add Account" then "Other" then "Add Mail Account"

Now you should see a "New Account" window that has the following: name, email, password, and a description. Fill in those fields, then hit "Next".

* Make sure "IMAP" is selected at the top of the screen.
* The Name, Email, and Description should appear as you entered them on the previous page
* Under INCOMING MAIL SERVER:
** Set Host Name to '''mail.swcp.com'''
** Enter your SWCP username in the User Name field (this name may be different from your email address)
** Your SWCP password should already be entered, from the previous page
* Under OUTGOING MAIL SERVER:
** Set Host Name to '''mail.swcp.com'''
** Enter your SWCP username in the User Name field (this name may be different from your email address)
** You need to enter the password again here
* Tap "Next", and on the next screen tap "Save"

Now you can leave the Settings app and open the Mail app to use this account.

=Testing your email account=
The easiest way to see if email flows both in and out is to send yourself an email from the SWCP account to the SWCP account.

If your receive your test email, then your email is functioning correctly.

=How to adjust the Advanced Settings=
For almost all email accounts, this is not necessary to do.
However, if you accidentally adjusted something in the "Advanced Settings" you might want to know how to change the settings back to a working state.

* Open the "Settings" app on your iPhone or iPad
* Go to "Password & Accounts" on the left-hand side
* Tap on your SWCP account
* Tap on "Account"
* Tap on "SMTP"

Now you can adjust the ''outgoing'' mail server advanced settings.

* Make sure that "Server" at the top is enabled
* "Host Name" needs to be set to: '''mail.swcp.com'''
* Make sure username is spelt correctly and does not have an ''@'' sign or anyhthing else after the ''@'' sign
* Make sure you have the correct password as well
* Turn on the "Use SSL" button
* Make sure that "Authentication" is set to '''Password'''
* Make sure that "Server Port" is set to '''587'''
* Tap on "Done" once complete.

* Tap on "Advanced" (at the bottom)

Now you can adjust the ''incoming'' mail server advanced settings.

* "Drafts Mailbox" can be set to '''Drafts'''
* "Sent Mailbox" can be set to '''Sent'''
* "Deleted Mailbox" can be set to '''Trash'''
* "Archive Mailbox" can be set to '''Archive''' (if one exists)
* Set "Move Discarded Messages Into" to '''Deleted Mailbox'''
* "Remove" can be set to '''After one week'''
* Turn on the "Use SSL" button
* "Authentication" needs to be set to '''Password'''
* "IMAP Path Prefix" needs to be '''empty'''
* "Server Port" needs to be set to '''993'''

=Deleting Messages=
Determining how messages will be deleted is important. It's irritating to read email on your iPhone, then go back to the office and have to wade through the same messages. You want to be able to delete messages from the iPhone and have your desktop email program recognize those deletions. This is an area where IMAP is essential. In the "Advanced Settings" for your iPhone mail account, you have these options to affect how messages are deleted:

* "Deleted mailbox" - can be "On My iPhone" or a named folder on the server. If it's "On My iPhone" the deleted messages get copied to a folder named Trash on your phone. DO NOT USE THIS OPTION.

* If "Deleted Mailbox" is set to a folder on the server (e.g. "Deleted Messages") then when you delete a message from any folder it gets COPIED to the "Deleted Messages" folder, *and* marked as "deleted" in the original folder.

When you go into the INBOX or other folders with your desktop client or webmail, the messages you deleted from the iphone will still be visible there, but marked "deleted". If you "Empty Trash" they'll get really deleted from the folder. A copy of them will still be in the "Deleted Messages" folder.

There's one more important setting on the iPhone: the "Remove" setting. It can be "After one day", "week", or "month". This controls how long the iPhone will leave messages in the "Deleted Messages" folder. "1 week" is a good setting. Every time you check mail from the iPhone, it nukes messages older than a week from the "Deleted Messages" folder. If you get a lot of large email attachments and delete from the iPhone, this could be a problem because of the disk space needed for the "Deleted Messages" folder. You could use a shorter period (1 day), or buy more disk space, or just resist the urge to delete those messages from the iphone.

Oh, one more thing: in order to select the "Deleted Messages" folder in the advanced settings, the folder had to be created ahead of time. You can create the folder in webmail, or using the IMAP client on your desktop computer (Thunderbird, mail.app, Outlook, etc.)

=The IMAP Folder Problem=

The IMAP server keeps a list of your "subscribed" folders. That is, files in your directory which are mail folders. That way most IMAP clients (like Outlook or Thunderbird or RoundCube webmail) know which files in your home directory to display as mail folders, and they ignore the rest. However, the iPhone ignores this subscription list and displays ALL the files it finds. This is irritating for a couple of different reasons, but there doesn't seem to be any fix for it, as of iPhone OS 3.x. Perhaps they'll fix it in <s>4.0 nope</s> <s>5.0 nope</s> <s>6.0 nope</s> <s>7.0 nope</s> <s>8.0 nope</s>

For some people this is no big deal. You just see a few extra files and you can mentally ignore them. For others, it's a big problem. For example, if your home directory also has a large web site stored, it might actually prevent the iPhone from being able to function, because it times out waiting for the huge (and useless!) file list to transfer.

Here are a couple of workarounds:
* '''[SWCP Only] Switch to maildir''' - at SWCP this issue does not affect accounts that are on our newer mail servers which use the "maildir" format for storing messages outside the user's home directory.
** '''NB''': If we change an account to maildir to fix this problem, you then need to delete the account from the device and re-add it. That seems to be the only way to get it to "forget" all those bogus folders that it saw.
* '''Only use INBOX''' - to do this, set Advanced -> Incoming Settings -> IMAP Path Prefix to the word "INBOX" (all capitals, no punctuation). Now when you access mail in this account, it will only show you your INBOX, and not any other IMAP folders that you might have. If you primarily use your phone to look at incoming mail and don't mind waiting until you are at your main computer to file messages into folders, this might work for you. But it means you can't access old messages that you previously filed into folders.
* '''Put folders in a subdirectory''' - to do this, create a subdirectory in your home directory on the SWCP server called "mail". In that directory create symbolic links to your folders one level up. Set the IMAP Path Prefix on the iPhone to the word "mail". Now the iPhone will only see those folders. (This won't disturb other IMAP clients you may be using such as Thunderbird, Outlook, or webmail). '''If you want to do this, please ask help@swcp.com to set it up for you.''' We'll take care of creating the directory and required links.

=See Also=
* [[Using Multiple Identities in iPhone Mail]]
* [[Configure K-9 on Android for SWCP Email]]
[[Category: Email]]
[[Category: iPhone]]

KB Email-3

2021-01-04T19:11:21Z

Cheeks: /* See Also */

==SWCP Email Server Settings==

This article contains the info you need to set up any email client to work with the SWCP mail servers.

* Outgoing mail server: mail.swcp.com
** Authenticated SMTP Port: 465
** Use SSL with Authenticated SMTP: Yes
*** or for TLS (mac mail tends to like this better)
**** Authenticated SMTP Port: 587
**** Use TLS with Authenticated SMTP: Yes
** What about good old port 25?
*** Port 25 works only under certain conditions, and is no longer intended for email client interaction. It is best to use Authenticated SMTP which should always work.

* Incoming mail server: mail.swcp.com
** Incoming Protocols: IMAP or POP. Again, we recommend you ONLY use the SSL versions of these services.
*** SSL IMAP Port: 993 '''(Recommended)'''
*** Standard (insecure) IMAP port: 143
*** SSL POP Port: 995
*** Standard (insecure) POP Port: 110

== See Also ==

* [[Authenticated SMTP]] - includes instructions for a variety of email software
* [[KB Email-1|Outlook 2003 with Auth SMTP and IMAP SSL]]
* [[KB Email-2|Outlook 2007 with Auth SMTP and IMAP SSL]]
* [[Apple Mail with Auth SMTP and IMAP SSL]]
* [[Configure iPhone for SWCP Email]]
* [[Configure K-9 on Android for SWCP Email]]
* [[Configure Thunderbird on Linux, MacOSX and Windows]]
* [[Configure Sendmail Client for Auth SMTP]] - Only useful if you run your own sendmail server
* [[Maximum Email Message Sizes]] - for different ISPs

[[Category: Email]]
[[Category: Webmail]]

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T19:04:17Z

Cheeks: /* Thunderbird on Windows or Mac OS X */

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T18:54:52Z

Cheeks: /* Thunderbird on Mac OS X */

==Thunderbird on Fedora 20 Linux==
This information kindly submitted by one of our users.

This applies specifically to Thunderbird on a Fedora 20 system, but should be applicable to most Linux desktop environments.

# Start Thunderbird and tell it to add a new account
#* If you select POP3, it should default to SSL/TLS on port 995 with password authentication.
#* If you select IMAP it should default to SSL/TLS on port 993 with password authentication.
# Outgoing mail should work with default settings, no special set-up needed.

The Thunderbird default account settings for POP leave the mail on the server, and some users may want to reset that option to load the mail to their home machine and remove from the server. With IMAP, all mail is left on the server (best choice if you use multiple devices to access your mail).

All done!

==Thunderbird on Windows or Mac OS X==

# Start Thunderbird, go to Tools > Account Settings. Click Account Actions, then Add Mail Account...
# Fill in the first 3 fields with your name, email address, and password. If you have an email address with your own domain name, use it here. If not, use your @swcp.com address.
# Click the "Configure manually" button, and fill in these settings:
#* Leave Protocol set to IMAP for incoming and SMTP for outgoing
#* Change the Server to "mail.swcp.com" for under both Incoming and Outgoing
#* Set SSL to "SSL/TLS" under both Incoming and Outgoing
#* Set Authentication to "Normal Password" for both Incoming and Outgoing
#* Set the Username to your SWCP Username
#* Click the "Re-Test" button to test the settings.
# Click Done

[[Category: Email]]

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T18:53:46Z

Cheeks: /* Thunderbird on Mac OS X */

==Thunderbird on Fedora 20 Linux==
This information kindly submitted by one of our users.

This applies specifically to Thunderbird on a Fedora 20 system, but should be applicable to most Linux desktop environments.

# Start Thunderbird and tell it to add a new account
#* If you select POP3, it should default to SSL/TLS on port 995 with password authentication.
#* If you select IMAP it should default to SSL/TLS on port 993 with password authentication.
# Outgoing mail should work with default settings, no special set-up needed.

The Thunderbird default account settings for POP leave the mail on the server, and some users may want to reset that option to load the mail to their home machine and remove from the server. With IMAP, all mail is left on the server (best choice if you use multiple devices to access your mail).

All done!

==Thunderbird on Mac OS X==

# Start Thunderbird, go to Tools > Account Settings. Click Account Actions, then Add Mail Account...
# Fill in the first 3 fields with your name, email address, and password. If you have an email address with your own domain name, use it here. If not, use your @swcp.com address.
# Click the "Configure manually" button, and fill in these settings:
#* Leave Protocol set to IMAP for incoming and SMTP for outgoing
#* Change the Server to "mail.swcp.com" for under both Incoming and Outgoing
#* Set SSL to "SSL/TLS" under both Incoming and Outgoing
#* Set Authentication to "Normal Password" for both Incoming and Outgoing
#* Set the Username to your SWCP Username
#* Click the "Re-Test" button to test the settings.
# Click Done

[[Category: Email]]

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T18:39:39Z

Cheeks: /* Thunderbird on Mac OS X */

==Thunderbird on Fedora 20 Linux==
This information kindly submitted by one of our users.

This applies specifically to Thunderbird on a Fedora 20 system, but should be applicable to most Linux desktop environments.

# Start Thunderbird and tell it to add a new account
#* If you select POP3, it should default to SSL/TLS on port 995 with password authentication.
#* If you select IMAP it should default to SSL/TLS on port 993 with password authentication.
# Outgoing mail should work with default settings, no special set-up needed.

The Thunderbird default account settings for POP leave the mail on the server, and some users may want to reset that option to load the mail to their home machine and remove from the server. With IMAP, all mail is left on the server (best choice if you use multiple devices to access your mail).

All done!

==Thunderbird on Mac OS X==

# Start Thunderbird, go to Tools > Account Settings. Click Account Actions, then Add Mail Account...
# Fill in the first 3 fields with your name, email address, and password. If you have an email address with your own domain name, use it here. If not, use your @swcp.com address.
# Click the "Configure manually" button, and fill in these settings:
#* Change the Server to "mail.swcp.com" for under both Incoming and Outgoing
#* Set SSL to "SSL/TLS" under both Incoming and Outgoing
#* Leave Authentication set to "Autodetect"
#* Set the Username to your SWCP Username
# Click Done

[[Category: Email]]

Configure Thunderbird on Linux, MacOSX or Windows

2021-01-04T18:38:33Z

Cheeks: /* Thunderbird on Fedora 20 Linux */

==Thunderbird on Fedora 20 Linux==
This information kindly submitted by one of our users.

This applies specifically to Thunderbird on a Fedora 20 system, but should be applicable to most Linux desktop environments.

# Start Thunderbird and tell it to add a new account
#* If you select POP3, it should default to SSL/TLS on port 995 with password authentication.
#* If you select IMAP it should default to SSL/TLS on port 993 with password authentication.
# Outgoing mail should work with default settings, no special set-up needed.

The Thunderbird default account settings for POP leave the mail on the server, and some users may want to reset that option to load the mail to their home machine and remove from the server. With IMAP, all mail is left on the server (best choice if you use multiple devices to access your mail).

All done!

==Thunderbird on Mac OS X==

# Start Thunderbird, go to Tools > Account Settings. Click Account Actions, then Add Mail Account...
# Fill in the first 3 fields with your name, email address, and password. If you have an email address with your own domain name, use it here. If not, use your @swcp.com address.
# Click the "Configure manually" button, and fill in these settings:
#* Change the Server to "mail.swcp.com" for under both Incoming and Outgoing
#* Set SSL to "SSL/TLS" under both Incoming and Outgoing
#* Leave Authentication set to "Autodetect"
#* Set the Username to your SWCP Username

[[Category: Email]]

Apple Mail with Auth SMTP and IMAP SSL

2020-02-19T01:12:26Z

Cheeks: /* Apple Mail with Auth SMTP and IMAP SSL */

==Apple Mail with Auth SMTP and IMAP SSL==

Here is how to configure Apple Mail on Mac OSX to work with SWCP's mail server.

# Open the Mail application on your Mac
# Go to '''Mail > Add Account...'''
# On the '''Add Account''' page, select '''Other Mail Account...''', then click Continue
# Enter your email account information:
#* '''Your Name:''' Enter the name you want recipients to see when they receive your message (e.g. "Bob Smith")
#* '''E-mail Address:''' username@swcp.com (Or name@yourdomain.com if you have your own email domain)
#* '''Password:''' your SWCP mailbox password.
#: Now click '''Sign In'''
#: This will pop up a new window which probably has a red message saying it was '''Unable to verify account name or password'''. That's OK, because we haven't given it all of the information yet. Fill out the empty fields on this screen:
#* '''User Name:''' username (where "username" is your SWCP login name - sometimes this is the same as the first part of your email address, but not always)
#* '''Account Type:''' IMAP (we recommend IMAP in almost all cases)
#* '''Incoming Mail Server:''' mail.swcp.com
#* '''Outgoing Mail Server:''' mail.swcp.com
# Click '''Done''' on the next page (about selecting the apps you want to use)

That's it! Mail should log in to your account and download the messages in your inbox right away.

[[Category: Email]]