Author: esr Date: 2008-12-27 13:30:02 +0000 (Sat, 27 Dec 2008) New Revision: 24798
Modified: trunk/website/pages/en/freemail.php Log: Recommend using the Web interface up front, as it's easier. Modified: trunk/website/pages/en/freemail.php =================================================================== --- trunk/website/pages/en/freemail.php 2008-12-27 10:44:41 UTC (rev 24797) +++ trunk/website/pages/en/freemail.php 2008-12-27 13:30:02 UTC (rev 24798) @@ -12,18 +12,14 @@ <p>You can download the latest pre-compiled version from <a href="http://downloads.freenetproject.org/alpha/plugins/Freemail/";>http://downloads.freenetproject.org/alpha/plugins/Freemail/</a></p> -<h3>The short version</h3> +<h3>The easy way to set up a Freemail account is to visit the Freemail +plugin, after you have downloaded it, through your <b>Plugins</b> web +page. The web interface will prompt you for an IMAP name, an IMPAP +password, and a Freemail shortname to associate with the account. +When the account is created, it will email you the secure name that it +generated for you.</h3> -<p>To setup an account for Freemail, execute the following commands:</p> -<pre> -java -jar Freemail.jar --newaccount <username> -java -jar Freemail.jar --passwd <username> <password> -java -jar Freemail.jar --shortaddress <username> <short-Freemail-address> -java -jar Freemail.jar -</pre> - -<p>Exchange the values within <brackets> with the appropriate -values. The chosen short Freemail-address must be unique and will give +<p>The chosen short Freemail-address must be unique and will give you an address looking like:</p> <ul> @@ -34,15 +30,111 @@ there because mail user and transport agents want to see an @ in addresses. Yes, we <em>do</em> know this is an ugly kludge.</p> +<p>Once you have installed the freemail plugin for your Freenet proxy +daemon, starting or restarting the daemon will start the freemail service +for you automatically.</p> + +<p>If for some reason you cannot make the web interface work, we have +included hand-configuration instructions down this page.</p> + +<h3>Mail client setup</h3> + +<p>Now you have the Freemail proxy running, which means that you can +send and receive emails through Freenet. For this we recommend that +you setup your favorite email client. </p> + +<p>The settings for the email client, illustrated below with fetchmail and the +Firefox-bundled Thunderbird email client, must be setup with the +following settings:</p> + +<ul> +<li><span style="font-weight:bold;">Incoming emails </span>- Protocol: <span style="font-weight:bold;">IMAP</span>, Server: +<span style="font-weight:bold;">localhost</span>, Port: <span style="font-weight:bold;">3143</span></li> +<li><span style="font-weight:bold;">Outgoing emails </span>- Protocol: <span style="font-weight:bold;">SMTP</span>, Server: +<span style="font-weight:bold;">localhost</span>, Port: <span style="font-weight:bold;">3025</span></li> +</ul> + +<p>Remember that the Freemail.jar program needs to be running whilst +you are reading and sending freemails.</p> + +<h3>fetchmail</h3> + +<p>You can easily make <a +href="http://fetchmail.berlios.de/";>fetchmail</a> poll your freenet +mail with an entry like this:</p> + +<pre> +poll freenet via localhost with proto imap port 3143 + user LOCALNAME here is IMAPNAME there with password PASSWORD +</pre> + +<p>This will cause Freemail mail to be automatically fetched and merged into +your normal incoming mail stream, so any of your email clients will see it. +Of course, you will need to change IMAPNAME and PASSWORD to match the +authetication pair you gave when you created the Freemail account, and LOCALNAME +to the local login you want to receive the mail.</p> + +<p>A variant of this recipe will still work if you have your freenet +node. running on another machine. Just change "localhost" to the DNS +address of the node host.</p> + +<h3>Thunderbird</h3> + +<p>If you use Thunderbird as your email client:</p> + +<ol> +<li> From the Edit menu, select Account Settings.</li> +<li> Click the Add Account... button.</li> +<li>Select Email Account and click Next.</li> +<li>Type in the name and either the long Freemail address you were given, or your short address if you created one. Check this carefully as an incorrect address here will not only mean people won't be able to reply to you, but your messages will appear as 'Spoofed'. Once you've done this, click Next.</li> +<li>Set the type of incoming server to IMAP and the incoming server name to localhost. Then click Next.</li> +<li>For the Incoming User Name, use the account name you chose earlier ('john' in this example), which may not be the same as your email +address. Click Next.</li> +<li>Enter an arbitrary Account Name and click Next and then Finish.</li> +<li>Now we have to change the IMAP port number from the default: On the left panel click on Server Settings under the new account. +Change the Port to 3143 from the default of 143.</li> +</ol> + +<p>Now you should be able to read incoming freemails. To send out emails:</p> + +<ol> +<li>From the Edit menu, select Account Settings.</li> +<li>In the left-hand panel, scroll down and click on the Outgoing Server (SMTP) option.</li> +<li>You probably already have at least one SMTP server set up already for your normal emails. So click on the Add... button to create +one specially for freemails.</li> +<li>Under Description put anything you want - Freemail might be a good choice. Set Server Name to localhost and change Port to 3025. +Make sure 'Use name and password' is checked and put your original account name as the User Name ('john' in our example). 'Use secure +connection' should be set to No (don't worry, it's only the local connection that is unencrypted). Click OK.</li> +<li>The final thing is to set your new Freemail account to use this outgoing server instead of the default one. So in the left panel +find and click on the top line of the new incoming mail account you added. In our example this would be something like [email protected]. There should be a drop-down box called Outgoing Server (SMTP). Set this to the new setup we just added: +something like Freemail - localhost. And click OK.</li> +</ol> + +<p>Congratulations - you're now set up to send and receive email over +Freenet!</p> + +<h3>Hand configuration</h3> + +<p>To set up an account for Freemail by hand, execute the following +commands:</p> + +<pre> +java -jar Freemail.jar --newaccount <username> +java -jar Freemail.jar --passwd <username> <password> +java -jar Freemail.jar --shortaddress <username> <short-Freemail-address> +java -jar Freemail.jar +</pre> + +<p>Exchange the values within <brackets> with the appropriate +values.</p> + <p>After running the last command you now have a running Freemail proxy, listening on localhost at IMAP port 3143 for incoming mails, and SMTP port 3025 for outgoing mails. Connect to it using your -favourite email client software</p> +favourite email client software.</p> -<p>If you didn't follow, read the long version below.</p> - - -<h3>The long version</h3> +<p>If you didn't follow, here's a longer and more detailed recipe:</p> <h3>Account Setup</h3> @@ -154,87 +246,6 @@ java -jar Freemail.jar </pre> -<p>Note: If you have installed the freemail plugin for your Freenet proxy -daemon, starting or restarting the daemon will start the freemail service -for you automatically.</p> - -<h3>Mail client setup</h3> - -<p>Now you have the Freemail proxy running, which means that you can -send and receive emails through Freenet. For this we recommend that -you setup your favorite email client. </p> - -<p>The settings for the email client, illustrated below with fetchmail and the -Firefox-bundled Thunderbird email client, must be setup with the -following settings:</p> - -<ul> -<li><span style="font-weight:bold;">Incoming emails </span>- Protocol: <span style="font-weight:bold;">IMAP</span>, Server: -<span style="font-weight:bold;">localhost</span>, Port: <span style="font-weight:bold;">3143</span></li> -<li><span style="font-weight:bold;">Outgoing emails </span>- Protocol: <span style="font-weight:bold;">SMTP</span>, Server: -<span style="font-weight:bold;">localhost</span>, Port: <span style="font-weight:bold;">3025</span></li> -</ul> - -<p>Remember that the Freemail.jar program needs to be running whilst -you are reading and sending freemails.</p> - -<h3>fetchmail</h3> - -<p>You can easily make <a -href="http://fetchmail.berlios.de/";>fetchmail</a> poll your freenet -mail with an entry like this:</p> - -<pre> -poll freenet via localhost with proto imap port 3143 - user LOCALNAME here is IMAPNAME there with password PASSWORD -</pre> - -<p>This will cause Freemail mail to be automatically fetched and merged into -your normal incoming mail stream, so any of your email clients will see it. -Of course, you will need to change IMAPNAME and PASSWORD to match the -authetication pair you gave when you created the Freemail account, and LOCALNAME -to the local login you want to receive the mail.</p> - -<p>A variant of this recipe will still work if you have your freenet -node. running on another machine. Just change "localhost" to the DNS -address of the node host.</p> - -<h3>Thunderbird</h3> - -<p>If you use Thunderbird as your email client:</p> - -<ol> -<li> From the Edit menu, select Account Settings.</li> -<li> Click the Add Account... button.</li> -<li>Select Email Account and click Next.</li> -<li>Type in the name and either the long Freemail address you were given, or your short address if you created one. Check this carefully as an incorrect address here will not only mean people won't be able to reply to you, but your messages will appear as 'Spoofed'. Once you've done this, click Next.</li> -<li>Set the type of incoming server to IMAP and the incoming server name to localhost. Then click Next.</li> -<li>For the Incoming User Name, use the account name you chose earlier ('john' in this example), which may not be the same as your email -address. Click Next.</li> -<li>Enter an arbitrary Account Name and click Next and then Finish.</li> -<li>Now we have to change the IMAP port number from the default: On the left panel click on Server Settings under the new account. -Change the Port to 3143 from the default of 143.</li> -</ol> - -<p>Now you should be able to read incoming freemails. To send out emails:</p> - -<ol> -<li>From the Edit menu, select Account Settings.</li> -<li>In the left-hand panel, scroll down and click on the Outgoing Server (SMTP) option.</li> -<li>You probably already have at least one SMTP server set up already for your normal emails. So click on the Add... button to create -one specially for freemails.</li> -<li>Under Description put anything you want - Freemail might be a good choice. Set Server Name to localhost and change Port to 3025. -Make sure 'Use name and password' is checked and put your original account name as the User Name ('john' in our example). 'Use secure -connection' should be set to No (don't worry, it's only the local connection that is unencrypted). Click OK.</li> -<li>The final thing is to set your new Freemail account to use this outgoing server instead of the default one. So in the left panel -find and click on the top line of the new incoming mail account you added. In our example this would be something like [email protected]. There should be a drop-down box called Outgoing Server (SMTP). Set this to the new setup we just added: -something like Freemail - localhost. And click OK.</li> -</ol> - -<p>Congratulations - you're now set up to send and receive email over -Freenet!</p> - <h3>Troubleshooting tips</h3> <p>If you try to run the Freemail jar and get messages that look like the _______________________________________________ cvs mailing list [email protected] http://emu.freenetproject.org/cgi-bin/mailman/listinfo/cvs
