Skip to content
TubePress — free, self-hosted & actively maintained
Users & administration

Email & Telegram notifications

Configure SMTP, customise transactional emails and get Telegram alerts.

Your site needs to reach people — password resets and contact replies go out by email, while you want to hear about new reports and messages the moment they land. TubePress handles both: transactional email through the provider of your choice, and instant pings over Telegram.

This page covers configuring outbound email and SMTP, customising the transactional templates, wiring up Telegram alerts, and the DNS records that keep your mail out of the spam folder. The first three live under Settings → Advanced.

Transactional email & SMTP

Open Settings → Advanced → Email to set up delivery. Start with the contact email — it receives contact-form submissions, report alerts and your test emails, and falls back to your admin account address if left empty. Then pick a mail provider:

PHP mail()
The server default. Works on most hosting, but deliverability is hit-and-miss.
SMTP
Works with any provider. Set the host, port, encryption (None, TLS or SSL), username and password.
Transactional API
Resend, Mailgun, Brevo, Postmark or SendGrid — paste the provider's API key (and domain/region where asked).

Set a From email and From name for every message, then click Send test email to confirm the configuration end-to-end before relying on it. Save your changes first — the test uses the saved settings and sends to your contact email.

Gmail via SMTP. Use smtp.gmail.com, port 587, TLS — and generate an App Password in your Google account rather than using your normal password.

Email templates

Every automatic message is a customisable transactional template, managed from the Email types screen. There are three:

TemplateGoes toDefault
Password resetThe visitorOn
Contact form notificationYou (admin)On
Content report notificationYou (admin)Off

Each can be switched on or off, or expanded to override its subject and HTML body, with a live inbox preview that renders the email in both desktop and mobile widths using sample data and your branding. Leave a field empty to keep the built-in default. Placeholders such as {name}, {site_name} and {reset_url} are filled in automatically — click any placeholder chip to copy it.

Disabling password reset breaks recovery. The password-reset email is how members regain access to their accounts — turn it off only if you deliberately handle recovery another way.

Telegram notifications

For instant alerts, connect a Telegram bot under Settings → Advanced → Telegram. You need two values:

  1. Message @BotFather in Telegram and send /newbot to get a bot token.
  2. Start a chat with your new bot (or add it to a group) and send it a message.
  3. Open https://api.telegram.org/bot<token>/getUpdates and copy the chat id from the response.
  4. Paste both in, save, and hit Send test message.

A personal chat id is a positive number; a group or channel id starts with -100. The test message uses whatever is currently in the form, so you do not need to save first. Then choose which events ping you:

New contact message
On — a visitor submits the contact form.
New content report
On — a visitor reports a video.
New registration
Off — a visitor creates an account.
New comment
Off — a visitor posts a comment.

Telegram is usually the easiest way to stay on top of reports and messages without watching your inbox.

Deliverability

Sending email is easy; landing in the inbox takes a little DNS work. Whatever provider you use, publish these records for your sending domain:

  • SPF — authorise your provider's servers to send as your domain.
  • DKIM — let your provider cryptographically sign your mail (they supply the key to publish).
  • DMARC — tell receivers what to do with mail that fails the checks, and get reports.

A few practical rules go a long way: send from a real address on a domain you control, make the From email match the domain you authenticated, and prefer SMTP or a transactional API over PHP mail() for anything that must arrive. Most providers will not deliver until the From domain is verified in their dashboard.

Test, then trust. After changing any DNS or provider setting, use Send test email and check that it arrives in the inbox — not spam — before you depend on password resets reaching real members.

Next steps

Still stuck?

Open a ticket from your dashboard and our team will help you out.

Try the live demo → Download TubePress →