Support / Email Search help
Setting up email alerts
Yardstick can email you when your Yarbo goes offline, gets stuck, or loses its position. It sends through your own mail account, to yourself — nothing passes through our servers, and it costs nothing.
The one thing that catches everybody
Use the sign-in method your provider supports. Eligible Gmail and Yahoo accounts can use an app password generated for a mail program. Gmail requires 2-Step Verification first, and account policies can still prevent app passwords. Personal Outlook.com and Hotmail accounts require OAuth2/Modern Auth, which Yardstick’s username/password SMTP sender does not offer.
Check your provider’s requirements before entering credentials. A normal password or app password cannot bypass a policy requiring a different authentication method.
Where the settings live
In Yardstick, open Settings → Notifications, switch Email on, and fill in Your mail account. Five things:
| Field | What goes in it |
|---|---|
| Mail server | Your provider's SMTP address — the tables below |
| Port | 587 almost always |
| Username | Your full email address, including the part after the @ |
| App password | The app password your provider permits, if supported |
| Send alerts to | Where the alerts should arrive — usually the same address |
Then press Save, and Send a test. The test tells you exactly what went wrong if it fails, which is worth more than guessing.
Gmail
Check Google’s app password requirements; security policies can make this option unavailable.
- Turn on 2-Step Verification: Google Account → Security. Without it the app password page does not exist — it will simply not be there.
- Go to myaccount.google.com/apppasswords, name it Yardstick, and create it.
- Copy the 16 characters. Google shows them in four groups with spaces — the spaces make no difference either way.
| Mail server | smtp.gmail.com |
| Port | 587 |
| Username | your full Gmail address |
| App password | the 16 characters |
Google shows an app password once. If you lose it, delete that entry and make a new one — there is no way to look it up.
Outlook.com and Microsoft 365
| Mail server | smtp.office365.com |
| Port | 587 |
| Username | your full address |
A personal outlook.com or hotmail.com account requires OAuth2/Modern Auth. An app password is not a supported workaround for Yardstick’s SMTP sender. See Microsoft’s Outlook.com settings. Choose a supported mail account or another notification channel.
A work or school mailbox is different. Ask its administrator whether password-based SMTP AUTH is permitted. The server and port above are Microsoft 365 settings, but they do not guarantee that your account accepts this sender. A disabled SMTP AUTH policy can produce this error:
5.7.139 Authentication unsuccessful, SMTP AUTH is disabled
Changing the password will not fix an authentication policy. The administrator must check both the mailbox’s authenticated SMTP setting and the organization’s allowed authentication methods. Enabling a mailbox option alone may not make password-based SMTP available. If it is not permitted, use another mail account or notification channel.
Yahoo Mail
Follow Yahoo’s app password instructions for your account.
| Mail server | smtp.mail.yahoo.com |
| Port | 587 |
| Username | your full Yahoo address |
Generate an app password under Account Security → Generate app password. Yahoo calls your normal password an "account key" in places, which is not the same thing and will not work here.
Any other provider
Your provider's help pages will list an SMTP or "outgoing mail" server. What you are looking for:
- Port 587 is the usual answer. Use it unless told otherwise.
- Port 465 if they say SSL rather than STARTTLS. Both work.
- Username is the whole address, not just the part before the @ — a surprising number of providers document it the other way and reject it anyway.
- If they offer app passwords for your account, use one. Otherwise, check the allowed authentication methods; your normal password may not work.
Your own mail server, or one from your internet provider, usually needs no app password at all — those are the easy ones.
When the test fails
| What it says | What it means |
|---|---|
| 535 / Username and Password not accepted | Almost always your normal password instead of an app password. Check two-factor is on and generate a new one. |
| 5.7.139 SMTP AUTH is disabled | A Microsoft 365 administrator has turned off authenticated SMTP for your mailbox. Only they can turn it back on. |
| Connection refused, or it hangs | Wrong port, or something on your network blocks outgoing mail. Try
465. Some internet providers block port 25 outright —
never use 25 here. |
| Name or service not known | A typo in the mail server address. |
| Sends fine, never arrives | Look in the junk folder. If it is there, see Landing in junk below — marking it "not spam" does not always work, and it is worth knowing why before you try it twenty times. |
Landing in junk
Alerts that send successfully but arrive in the junk folder are usually nothing to do with Yardstick, and there are two different causes worth telling apart.
If you signed in with a username and app password, as eligible Gmail and Yahoo accounts allow, your mail is authenticated and this section almost certainly does not apply to you. Marking one message "not spam" is normally enough.
If you left the username blank and send straight to your own company mail server, your mail arrives unauthenticated, and the receiving server judges it on what it can see. Two things then matter.
The first is the name your machine gives when it connects. Most Linux machines have a short name with no domain on it, and a mail server treats that as suspicious. Yardstick works out a proper name automatically and shows you what it settled on, under This machine's name on the network in Settings → Notifications. Leave it blank unless your machine has a proper name on your network, in which case put it in. Printers and phone systems call the same setting "My Origin" or "hostname".
The second is on the mail server's side, and only an administrator can fix it. Microsoft 365 in particular treats unauthenticated mail claiming to be from your own domain as a possible forgery, and in that case marking it "not spam" has no effect at all, because personal safe-sender lists are deliberately ignored for your own domains. The fix is an inbound connector that recognizes the machine by its IP address, set up once by whoever administers your mail. Microsoft documents this as SMTP relay with a connector, and it is worth doing rather than fighting the junk folder: it takes a couple of minutes and it fixes every device that sends from that address, not just Yardstick.
Where your password is kept
On your own computer, in Yardstick's settings file, and nowhere else. It is never sent to us, and it is deliberately left out of the diagnostics report — so that report stays safe to email to anybody, including us.
An app password can be revoked at your provider at any time without changing your account password, which is the other reason to use one.