Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/.vitepress/theme/components/Services/List.vue
Original file line number Diff line number Diff line change
Expand Up @@ -1697,9 +1697,9 @@ const services = [
category: 'Development'
},
{
name: 'Unsend',
slug: 'unsend',
icon: '/docs/images/services/unsend-logo.svg',
name: 'Usesend',
slug: 'usesend',
icon: '/docs/images/services/usesend-logo.png',
description: 'Open-source email recall service.',
category: 'Email'
},
Expand Down
13 changes: 0 additions & 13 deletions docs/public/images/services/unsend-logo.svg

This file was deleted.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/public/images/services/usesend-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/services/all.md
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ Complete directory of all one-click services available in Coolify, organized by

## Email

- [Unsend](/services/unsend) - An open source bulk email manager
- [Usesend](/services/usesend) - An open source bulk email manager

## Family

Expand Down
16 changes: 0 additions & 16 deletions docs/services/unsend.md

This file was deleted.

113 changes: 113 additions & 0 deletions docs/services/usesend.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
---
title: Usesend
description: "Send emails on Coolify with Usesend for developer-focused email API, templates, testing, and transactional email delivery service."
---

# Usesend
<br/>
<ZoomableImage src="/docs/images/services/usesend-hero-dark.webp" alt="Usesend dashboard" />

## What is Usesend

Usesend is an open-source alternative to Resend, Sendgrid, Mailgun and Postmark etc.

There are some setup to be made, please refer to the [official documentation](https://docs.usesend.com/self-hosting/overview?utm_source=coolify.io) for more information.

## SMTP Configuration

Running Usesend with SMTP support requires an additional relay component to handle incoming SMTP requests. This relay service binds to multiple ports supporting both SSL and TLS connections.

### Prerequisites

Before configuring the SMTP relay, you need to add a certificate dumper to your Traefik proxy configuration to make Coolify's SSL certificates accessible to the relay:

1. Navigate to **Server** → **Proxy** → **Configuration**
2. Add the following certificate dumper configuration:

```yaml
traefik-certs-dumper:
image: ghcr.io/kereis/traefik-certs-dumper:latest
container_name: traefik-certs-dumper
restart: unless-stopped
depends_on:
- traefik
volumes:
- /etc/localtime:/etc/localtime:ro
- /data/coolify/proxy:/traefik:ro
- /data/coolify/certs:/output
```

This service extracts Traefik-managed certificates and outputs them to `/data/coolify/certs/`, making them available for the SMTP relay to use for SSL and TLS connections.

### Adding the SMTP Relay Service

Add the following service at the end of the compose file (by clicking on "Edit compose file" when adding the service):

:::info
Replace `###USESEND FQDN (e.g. usesend.example.com)###` with your unsend domain name in the configuration below.
:::
```yaml
smtp-server:
container_name: usesend-smtp-server
image: 'usesend/smtp-proxy:latest'
volumes:
- type: bind
source: /data/coolify/certs/###USESEND FQDN (e.g. usesend.example.com)###/key.pem
target: /data/certs/key.pem
read_only: true
- type: bind
source: /data/coolify/certs/###USESEND FQDN (e.g. usesend.example.com)###/cert.pem
target: /data/certs/cert.pem
read_only: true
environment:
- SMTP_AUTH_USERNAME=usesend
- SERVICE_FQDN_SMTP
- 'USESEND_BASE_URL=${SERVICE_URL_USESEND_3000}'
- USESEND_API_KEY_PATH=/data/certs/key.pem
- USESEND_API_CERT_PATH=/data/certs/cert.pem
ports:
- '25:25'
- '587:587'
- '2587:2587'
- '465:465'
- '2465:2465'
healthcheck:
test:
- CMD
- nc
- -z
- localhost
- "25"
interval: 30s
timeout: 10s
retries: 3
start_period: 10s
```

Then add those environment variables to the main Usesend service:

```yaml
- SMTP_HOST=${SERVICE_FQDN_SMTP}
- SMTP_USER=${SMTP_AUTH_USERNAME}
```

### Using Usesend SMTP in Your Applications

Once the relay is deployed, configure your sending applications with the following settings:

- **SMTP Host**: Your Usesend URL
- **SMTP Port**: 465 (SSL) or 587 (TLS/STARTTLS)
- **Username**: `usesend`
- **Password**: Your Usesend API key (generated from the Usesend dashboard)

The relay supports multiple ports for compatibility with different applications:
- **Standard SMTP**: Ports 25, 587, 2587
- **SSL/TLS**: Ports 465, 2465

You can verify that emails are being sent successfully through Usesend's deliverability reports and message previews in the dashboard.

## Links

- [Official Documentation](https://docs.usesend.com/self-hosting/overview?utm_source=coolify.io)
- [Official Website ↗](https://usesend.com?utm_source=coolify.io)
- [GitHub ↗](https://github.com/usesend/usesend)