dotCloud

Documentation

Getting Started with dotCloudDeployment GuideConfiguration Guide
Quickstart GuideGet started with dotCLOUD RelayHow to Configure Exchange Online to Accept Emails from a SaaS RelayEnabling SmtpClientAuthentication (SMTP AUTH) in Exchange OnlineGuide: Securely Allowing SMTP AUTH for a Single User

Quickstart Guide

Last updated: 11/7/2025

dotCLOUD Relay - Onboarding Documentation

A step-by-step guide to integrate dotCLOUD Relay with your application or website.

👋 Welcome Aboard!

This guide will walk you through the essential steps to set up your dotCLOUD Relay service for reliable email delivery. Follow these steps to ensure optimal deliverability and performance.

1

Create Your Account

  1. Navigate to https://relay.dotcloud.red/auth/sign-up
  2. Complete the registration form with your business details
  3. Verify your email address by clicking the link sent to your inbox
  4. Log in to your new dotCLOUD Relay dashboard at https://relay.dotcloud.red/auth/login
⏱️ Estimated time: 5 minutes
2

Choose Your Plan

  1. From your dashboard, navigate to the Pricing or Billing section
  2. Review the available plans and select the one that matches your email volume needs
  3. If you're on a free trial, you can explore the service before committing to a paid plan
  4. Enter your payment information (if applicable)
💡 Tip: Start with a lower-tier plan and upgrade as your needs grow. You can change plans at any time.
3

Configure Your SMTP Settings

Retrieve Your SMTP Credentials

  1. In your dashboard, navigate to Settings or SMTP Configuration
  2. Note your unique SMTP credentials:
    • SMTP Server: [Provided in dashboard]
    • Port: 587
    • Username: Your account-specific username
    • Password: Your secure SMTP password or API key
    • Encryption: [TLS/STARTTLS/SSL]

Configure Your Application

Update your application's email settings with the dotCLOUD Relay SMTP credentials. Here are examples for common scenarios:

Example: WordPress SMTP Plugin

SMTP Host: [Provided in dashboard]
SMTP Port: 587
Encryption: TLS
Authentication: Yes
Username: [your-username]
Password: [your-password]

Example: Custom Application (Python)

import smtplib
from email.mime.text import MIMEText

smtp_server = "[Provided in dashboard]"
port = 587
sender = "your-email@yourdomain.com"
password = "[your-password]"

msg = MIMEText("Test email body")
msg['Subject'] = "Test Email"
msg['From'] = sender
msg['To'] = "recipient@example.com"

with smtplib.SMTP(smtp_server, port) as server:
    server.starttls()
    server.login(sender, password)
    server.send_message(msg)

Example: .NET Application (C#)

using System.Net;
using System.Net.Mail;

var smtpClient = new SmtpClient("[Provided in dashboard]")
{
    Port = 587,
    Credentials = new NetworkCredential("[your-username]", "[your-password]"),
    EnableSsl = true,
};

var mailMessage = new MailMessage
{
    From = new MailAddress("your-email@yourdomain.com"),
    Subject = "Test Email",
    Body = "Test email body",
    IsBodyHtml = false,
};
mailMessage.To.Add("recipient@example.com");

smtpClient.Send(mailMessage);
⏱️ Estimated time: 10-15 minutes
4

Verify Your Domain (Recommended)

To maximize deliverability and ensure emails are sent from your domain:

  1. Navigate to Domain Settings in your dashboard
  2. Add your sending domain (e.g., yourdomain.com)
  3. Follow the instructions to add DNS records:
    • SPF Record: Add the provided TXT record to authorize dotCLOUD Relay
    • DKIM Record: Add the DKIM signature record for email authentication
    • DMARC Record: Configure your DMARC policy (optional but recommended)
  4. Click Verify Domain to confirm the DNS records are correctly configured
  5. Wait for verification (typically 5-60 minutes depending on DNS propagation)
⏱️ Estimated time: 15-30 minutes (including DNS propagation)
5

Send Your First Test Email

  1. From your dashboard, navigate to Test Email or Send Test
  2. Enter a recipient email address (use your own email for testing)
  3. Click Send Test Email
  4. Check your inbox to confirm delivery
  5. Review the delivery status in your dashboard
⏱️ Estimated time: 2 minutes
6

Monitor Your Email Activity

Dashboard Overview

Your dashboard provides real-time insights into your email activity:

  • Total Emails Sent: Track your usage against your plan limits
  • Delivery Rate: Monitor successful deliveries
  • Bounce Rate: Identify delivery issues
  • Recent Activity: View your latest email sends

Email Logs

Access detailed logs for troubleshooting:

  1. Navigate to Logs or Email History
  2. Filter by date, recipient, status, or subject
  3. Click on individual emails to view detailed delivery information
7

Optimize for Production

Best Practices

  1. Authenticate Your Domain: Ensure SPF, DKIM, and DMARC are properly configured
  2. Monitor Bounce Rates: Regularly review bounces and remove invalid addresses
  3. Respect Rate Limits: Stay within your plan's sending limits to avoid throttling
  4. Use Meaningful From Addresses: Use recognizable sender addresses to improve deliverability
  5. Include Unsubscribe Links: For marketing emails, always include unsubscribe options

Security Recommendations

  1. Rotate Credentials Regularly: Change your SMTP password periodically
  2. Restrict IP Access: Use IP whitelisting if available
  3. Enable Two-Factor Authentication: Protect your dashboard access
  4. Monitor for Unauthorized Access: Review login activity regularly

Scaling Your Usage

As your email volume grows:

  1. Monitor your usage in the dashboard
  2. Upgrade your plan before reaching limits to avoid service interruption
  3. Contact sales for custom enterprise plans with higher volumes
💡

Common Integration Scenarios

Integrating with CRM Systems

dotCLOUD Relay works seamlessly with popular CRM platforms including:

  • Salesforce
  • Microsoft Dynamics 365
  • HubSpot
  • Zoho CRM

Integrating with E-commerce Platforms

Send transactional emails from your online store:

  • Shopify
  • WooCommerce
  • Magento
  • BigCommerce

Integrating with Marketing Automation

Enhance your marketing campaigns with reliable email delivery:

  • Mailchimp
  • ActiveCampaign
  • Marketo
  • Pardot
💡 Need Integration Help? Contact our support team for specific integration guides and assistance.
🔧

Troubleshooting Common Issues

Emails Not Sending

  1. Verify SMTP credentials are correct
  2. Check that your application can reach the SMTP server (firewall rules)
  3. Ensure you haven't exceeded your plan's sending limits
  4. Review error messages in your application logs

Emails Going to Spam

  1. Verify your domain authentication (SPF, DKIM, DMARC)
  2. Ensure your sending domain has a good reputation
  3. Avoid spam trigger words in subject lines
  4. Include a physical address and unsubscribe link

Authentication Failures

  1. Double-check username and password
  2. Ensure you're using the correct port and encryption method
  3. Verify your account is active and in good standing
  4. Check for any special characters in your password that may need escaping

✅ Next Steps - You're Ready!

Account created and verified
SMTP configured in your application
Domain authenticated
Test email sent successfully
Monitoring dashboard reviewed

🎉 You're ready to start sending emails with dotCLOUD Relay!

For advanced configurations, API integration, or enterprise features, please refer to our detailed documentation or contact our support team.

📋 Quick Reference Card

Setting Value
SMTP Server [Available in your dashboard]
Port [587]
Encryption [TLS/SSL - Check dashboard]
Authentication Required
Username [From dashboard]
Password [From dashboard]
Dashboard URL relay.dotcloud.red
Support Email help@dotcloud.pro