Remote › Mail
PremiumThe Remote mail page reads the mailboxes of your domains without setting up a mail program: over IMAP with all folders and search, or over POP3 for the inbox. Reading moves, deletes or marks nothing as read. With an outgoing server you can also write your own mails from an account, or send them only to the local Mailpit as a test. Remote mail is a Premium feature.
What you do here
- Set up a mail account: through an SSH connection or directly, with a connection test and an outgoing server.
- Read and search mail: folders, list, preview, headers and attachments.
- Write mail: through the account's outgoing server or as a test to Mailpit.
- Outbox: what you wrote in WebDonkey and whether it arrived.
Page layout
- Header: title and short description, on the right Add mail account, Write mail, Refresh, edit (pencil) and remove (bin). The last four need a selected account.
- Risk notice: the strip Caution: working directly on the server, as on every Remote page.
- Connections (left): your servers, under each server its mail accounts. Accounts connected directly from this Mac are in the group Without SSH connection. A click on an account opens it.
- Folders: at the top protocol and route (such as "IMAP · SSH Production"), below it the folders with the number of unread or all mails, at the very bottom the Outbox.
- Mail list: search field, the mails of the folder, at the bottom the range with paging.
- Preview: the selected mail. Without a selection it says Pick a mail on the left.
In a narrow window, folders and list share the space, and an open mail lies on top as a sheet. Back closes it again.
Without any account, the page suggests adding a mailbox, with the button Add mail account. While the page is visible it refreshes every minute.
Free and Premium
Remote mail is entirely Premium, reading as well as writing. Without Premium a lock lies over the page. Prices are at webdonkey.io/pricing.
From the command line
wd remote mail lists the mailboxes; with folders, messages and show you read folders and mails. Writing is not possible from the command line. More under Servers (Remote).
Set up a mail account Premium
A mail account connects WebDonkey to a mailbox on a mail server. The easiest way is through a saved SSH connection: WebDonkey then talks to the mail server as if it sat on the server itself, and opens no port to the outside for it. Alternatively you connect directly from this Mac, as with a mail program.
Where to find it
Sidebar Remote › Mail, then Add mail account at the top right. You pick an existing account on the left and open it with the pencil (Edit mail account).
How to do it
- Click Add mail account.
- Enter a Name, such as "Shop · info@", and choose the Protocol: IMAP or POP3.
- Choose the route: Through a saved SSH connection with the server below it, or Directly from this Mac.
- Check Server, Port and Encryption. Through SSH the server usually already reads
127.0.0.1. - Enter the mailbox's User name and Password.
- Click Test connection. On success, a green line says the login worked, with the number of folders, the mails in the inbox and the time in milliseconds.
- If you also want to write mails, unfold Outgoing server (SMTP, for sending mail) and enter the outgoing server, see below.
- Click Save. The account appears on the left and opens on its inbox.
Test connection and Save unlock once server, port, user name and password are there, through SSH also the connection. The test logs in with the form as it is filled in and saves nothing.
Fields and options
| Field | Meaning |
|---|---|
| Name | What the account is called in the list. Left empty, WebDonkey uses the server. |
| Protocol | IMAP: all folders, search on the server. POP3: the inbox only. |
| Through a saved SSH connection | Server and port as seen from that server, usually 127.0.0.1. The mail connection runs inside the SSH session; no port is opened anywhere. Preselected as soon as there is an SSH connection. WebDonkey then fills in the connection's user name and certificate name. |
| Directly from this Mac | Server, port and credentials as in a mail program. |
| Server | Name or address of the mail server, such as imap.example.com. |
| Port | Follows protocol and encryption as long as you do not change it yourself: IMAP 993 with TLS, otherwise 143. POP3 995 with TLS, otherwise 110. |
| Encryption | TLS (default), STARTTLS or None. Without encryption and without SSH, the dialog warns that the password travels readable over the network. Through SSH it stays inside the tunnel. |
| User name, Password | The login to the mailbox. When editing, the password field reads unchanged: left empty, the stored password stays. |
| Certificate name | Only with encryption: the name the certificate is issued for. Needed when you reach the server as 127.0.0.1. |
| Do not check the certificate | Only with encryption. Only for self-signed test servers; otherwise anyone in between could read along. |
Outgoing server (SMTP, for sending mail)
You only need the outgoing server if you want to write mails through this account that actually reach recipients. Without one, mails you write go only to the local Mailpit as a test.
| Field | Meaning |
|---|---|
| Server | The SMTP server, through SSH usually 127.0.0.1, directly such as smtp.example.com. Left empty, the account has no outgoing server. |
| Port | Follows the encryption: 587 with STARTTLS (default), 465 with TLS, 25 with None. |
| Encryption | STARTTLS, TLS or None. |
| Sender address | The address shown as sender. Left empty, WebDonkey uses the user name. |
| Same login as for reading | Preselected. Untick it to enter a separate User name and Password for the outgoing server. |
The outgoing server uses the same route as reading, so through SSH it goes through the tunnel too.
What happens in the background
- WebDonkey stores passwords encrypted, like the credentials of your SSH connections.
- When reading, WebDonkey opens folders for viewing only. Mails are not marked as read, moved or deleted.
Edit and remove
- The pencil opens Edit mail account.
- The bin asks Remove mail account?. The account and its stored password leave WebDonkey. The mailbox on the server is not touched.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| User name or password was not accepted. | Wrong login. | Check the credentials. |
| The mail server could not be reached | Wrong server or port, or a firewall blocks it. | Check server and port. Through SSH: use the address as seen from the server. |
| The server did not answer like a mail server … | Port and encryption do not match. | Check port and Encryption. |
| The server does not offer STARTTLS … | STARTTLS chosen, the server cannot do it. | Choose TLS or another port. |
| The server’s certificate is not valid for this name … | Self-signed or issued for another name. | Enter the Certificate name; for a test server, Do not check the certificate. |
| The SSH server could not reach the mail server … | The port is closed on the server, or forwarding is not allowed there. | Check address and port, or use Directly from this Mac. |
| Through a saved SSH connection is locked | There is no SSH connection. | Add one under Connections. |
See also
Read and search mail Premium
Pick a mail account and WebDonkey shows its folders, the mails in them and the mail you select. HTML mails open in a safe preview that loads nothing from the web. It only reads: no mail is moved, deleted or marked as read.
Where to find it
Sidebar Remote › Mail, then click the account on the left under Connections.
How to do it
- Pick the account on the left. It opens on the Inbox.
- With IMAP, pick another folder if needed.
- Click a mail in the list. The preview appears on the right.
- Switch at the top of the preview between HTML, Text, Headers and Attachments.
- To save an attachment: tab Attachments, then Save….
Folders
With IMAP all folders of the mailbox are listed on the left. Folders with a known role show it in the app's language and with an icon of their own: Inbox, Sent, Drafts, Trash, Junk and Archive. If two folders share a role, both keep their name on the server. Next to each folder stands the number of unread mails, otherwise the number of all mails. Folders that cannot be opened are dimmed.
With POP3 there is only the Inbox.
At the very bottom is the Outbox with the mails you wrote in WebDonkey.
The mail list
Each row shows the sender, a paper clip for attachments, the date (today the time, this year weekday and date), the subject, the recipients and the size. Unread mails carry a dot and are bold. Without a subject it says (no subject). An empty folder shows This folder is empty.
The list shows 50 mails per page, newest first. At the bottom it says which mails you see and how many there are; the arrows page through.
Searching
Type into Search subject or sender… and press Enter. The search covers subject and sender.
- With IMAP, the mail server searches the whole folder.
- With POP3, WebDonkey searches the newest 1000 mails. If there are more, the bottom says searched the newest 1000.
Without a match it says No mail matches. The x in the search field clears the search.
The preview
At the top are subject, From, To, Cc where present, Date and size. Below are the tabs:
| Tab | Content |
|---|---|
| HTML | Only for HTML mails, then preselected. The mail runs in a sealed-off view that executes nothing and loads nothing, no images from the web either. On the right it says whether and how many external contents were blocked. |
| Text | The text part. Without one it says No text part. |
| Headers | All header lines of the mail as a table, for example to check the sender and the route of the mail. |
| Attachments | Only if there are any, with their number. Each attachment with name, type, size and Save…. Images embedded in the HTML carry inline. If there are only those, it says Only images shown inside the HTML. |
Save… asks for a place on your Mac and then reports Saved: with the path.
What happens in the background
- The page asks the server for new mails every minute while the page is open and the window is visible. Refresh asks right away.
- Through SSH the mail connection runs inside the SSH session; directly it goes from your Mac to the mail server.
- WebDonkey does not show mails larger than 60 MB.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| Red error above the list | The server could not be reached or refused. | Check the account with Test connection, see Set up a mail account. |
| The mail no longer exists … | It was deleted or moved on the server in the meantime. | Click Refresh. |
| This mail is too large to show here | The mail is larger than 60 MB. | Read it in a mail program. |
| The connection to the mail server broke off | Network or SSH session interrupted. | Try again. |
See also
Write mail Premium
Write mail sends a mail of your own from a mail account, for example to check whether your server accepts and delivers mail. It goes out to real recipients through the account's outgoing server (SMTP), or as a test only to the local Mailpit on your Mac. Every attempt lands in the Outbox, with the server's answer.
Where to find it
Sidebar Remote › Mail, pick an account on the left, then Write mail at the top right. The dialog is called Write mail; its subtitle shows the sender address after From:.
How to do it
- Pick the account and click Write mail.
- Choose the route at the top: Through … (the outgoing server with its port) or Only to the local Mailpit.
- Enter the recipients under To. For more recipients click Cc / Bcc.
- Enter the Subject and write the Message, as Text or as HTML.
- Attach files with Attach file… if you like.
- Click Send, for the test Send to Mailpit. While it sends, the button reads Sending….
- Once the server has accepted the mail, the dialog closes and the outbox shows the mail with the server's answer.
Send unlocks as soon as there is at least one recipient in To, Cc or Bcc.
Fields and options
| Field | Meaning |
|---|---|
| Through … | Sending through the account's outgoing server. Goes out to the recipients. Preselected when the account has an outgoing server. |
| Only to the local Mailpit | A test: the mail stays on this Mac and shows up on the Mail page. There it carries the tag WebDonkey-Test. |
| To | One or more addresses, separated by comma, semicolon or line break. Name <address> works as well. |
| Cc, Bcc | Appear after a click on Cc / Bcc. Bcc recipients do not appear in the mail's header. |
| Subject | The subject. |
| Message | The content. The Text / HTML switch next to it sets the format. With HTML you write HTML; WebDonkey makes the text part for mail programs without HTML from it. |
| Attach file… | Picks one or more files on your Mac. Each stands as a chip with an x to remove it. Together at most 25 MB and 20 files. |
Without an outgoing server
If the account has no outgoing server, there is no choice of route. Instead a yellow box says the mail only goes to the local Mailpit as a test and does not reach the recipients. Set up SMTP closes the dialog and opens the mail account right at the section Outgoing server (SMTP, for sending mail), see Set up a mail account. The Write mail button already points this out when you hover over it.
What happens in the background
- The mail takes the same route as reading: through SSH via the tunnel, otherwise directly from your Mac.
- WebDonkey files no copy in the mailbox's Sent folder. What you wrote is in the outbox on this Mac.
- The outbox keeps attachments by name and size only, not the files themselves.
- For the test, WebDonkey talks to Mailpit on this Mac, without encryption and without login. Mailpit has to be running for it.
Free and Premium
Writing mail is Premium, like the whole page.
Troubleshooting
If the server does not accept the mail or cannot be reached, the dialog stays open. The red message starts with Not sent: and gives the reason; the attempt is still in the outbox. Errors that show before sending, with addresses or attachments for example, appear in the dialog without an outbox entry.
| What you see | Why | What to do |
|---|---|---|
| Enter at least one recipient. | All address fields are empty. | Enter recipients. |
| The recipient address is not valid. | An address cannot be read. | Check the spelling. |
| The sender address is not valid. | The account's Sender address is wrong. | Fix it in the mail account. |
| The attachments are too large together (at most 25 MB and 20 files). | Too much attached. | Shrink or drop attachments. |
| An attachment could not be read | The file was moved or deleted. | Attach the file again. |
| The outgoing server did not accept the login. | Wrong SMTP credentials. | Check them in the mail account, perhaps with a separate login instead of Same login as for reading. |
| The outgoing server refused the mail | The server turned down sender or recipient. | Read the server's answer in the outbox. |
| Mailpit is not running. Start it under Mail, then send again. | Mailpit is not running for the test. | Start Mailpit on the Mail page. |
See also
Outbox Premium
The Outbox shows every mail you wrote from an account in WebDonkey with Write mail, sent or not, with the server's answer or the reason it failed. It lives on this Mac, not on the server. That way you can still see later whether and how a test mail arrived.
Where to find it
Sidebar Remote › Mail, pick an account on the left, then Outbox at the very bottom of the folder column. After sending, WebDonkey opens the outbox by itself and selects the new mail.
How to do it
- Click Outbox at the bottom of the folder column. The number of entries stands next to it. If some failed, their number shows in red instead.
- Pick an entry in the list. On the right are the mail, its status and the server's answer.
- Write again opens it as a new mail; the bin removes it from the outbox.
The list
Above the list it says Written in WebDonkey · kept on this Mac. Each entry shows:
- an icon for the status: green check for sent, flask for a test to Mailpit, red exclamation mark for failed,
- the recipients, a paper clip for attachments and the date,
- the subject,
- Sent or Failed and the route: the server with its port (through SSH with the connection's name) or Local test · Mailpit.
The newest mail is at the top. When the outbox is empty, it says nothing has been written yet and that every mail you write here shows up in this list.
An entry
| Part | Meaning |
|---|---|
| Subject and mark | Sent (green, neutral for Mailpit) or Failed (red). |
| From, To, Cc, Bcc, Date | As written. |
| Sent via | The route: server with port or Local test · Mailpit. |
| Answer | On success Accepted by the server: with the server's last answer, on failure the reason in red. |
| Tabs | HTML (only for HTML mails, in the same sealed-off view as when reading), Text and Attachments with name and size. |
Buttons
| Button | What it does |
|---|---|
| Show in Mailpit | Only for a test to Mailpit: opens the Mail page. |
| Write again | Opens Write mail with the same recipients, subject and text. You pick attachments again, because the outbox does not keep them. For an HTML mail the text part is made anew from the HTML. |
| Bin (Remove from the outbox) | Removes the entry right away, without asking. The mail itself is not affected; it was sent already, or never. |
What happens in the background
- The outbox lives in WebDonkey's database on this Mac, separately for each account. The list shows the newest 500 entries.
- It keeps attachments by name and size only.
- Every attempt to send is kept, also one the server refused or one where the server could not be reached. A mail that could not even be put together, without a valid address or with an attachment that could not be read, for example, does not appear in the outbox. The dialog Write mail shows that error instead.
- WebDonkey writes nothing into the mailbox on the server, no copy in Sent either.
Free and Premium
The outbox is Premium, like the whole page.