Buy

Remote › Mail

Premium

The 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

  1. Click Add mail account.
  2. Enter a Name, such as "Shop · info@", and choose the Protocol: IMAP or POP3.
  3. Choose the route: Through a saved SSH connection with the server below it, or Directly from this Mac.
  4. Check Server, Port and Encryption. Through SSH the server usually already reads 127.0.0.1.
  5. Enter the mailbox's User name and Password.
  6. 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.
  7. If you also want to write mails, unfold Outgoing server (SMTP, for sending mail) and enter the outgoing server, see below.
  8. 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

  1. Pick the account on the left. It opens on the Inbox.
  2. With IMAP, pick another folder if needed.
  3. Click a mail in the list. The preview appears on the right.
  4. Switch at the top of the preview between HTML, Text, Headers and Attachments.
  5. 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

  1. Pick the account and click Write mail.
  2. Choose the route at the top: Through … (the outgoing server with its port) or Only to the local Mailpit.
  3. Enter the recipients under To. For more recipients click Cc / Bcc.
  4. Enter the Subject and write the Message, as Text or as HTML.
  5. Attach files with Attach file… if you like.
  6. Click Send, for the test Send to Mailpit. While it sends, the button reads Sending….
  7. 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

  1. 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.
  2. Pick an entry in the list. On the right are the mail, its status and the server's answer.
  3. 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.

See also

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy