useSend
Conteneur LXC DevScripts
Accès par défaut
- Adresse
http://ADRESSE-IP:3000Remplacez ADRESSE-IP par l'adresse donnée à la fin de l'installation.- Compte et mot de passe
- Aucun identifiant fixe publié par la source : voir ci-dessous.
- Console et SSH
- Console du conteneur dans l'interface Proxmox : compte
root, connexion automatique sans mot de passe. Le SSH derootn'est ouvert que si vous l'avez demandé à l'installation. - Configuration
/opt/usesend_data/.env
- useSend has no local accounts. Sign-in is GitHub OAuth (Google OAuth works too, but only behind an HTTPS domain); the email code login cannot work on a fresh instance, because useSend sends that code through its own verified SES domain. Create a GitHub OAuth app with the callback URL http://<IP>:3000/api/auth/callback/github and pass var_github_id and var_github_secret, or fill in GITHUB_ID and GITHUB_SECRET in /opt/usesend_data/.env afterwards and run systemctl enable --now usesend usesend-smtp. The services do not start until then.
- The SMTP proxy (usesend-smtp) accepts mail on 465 and 2465 (TLS) and 587 and 2587 (STARTTLS), user usesend and a useSend API key as password, and hands it to the API. Its certificate in /etc/ssl/usesend is self-signed and valid for one year. Port 25 is offered too unless another mail server already listens there.
useSend is an open-source email sending platform and self-hosted alternative to Resend, SendGrid or Postmark. It sends transactional email through a REST API, SDKs or SMTP, and marketing campaigns to contact books from a visual editor, with domain verification, delivery, open and click tracking, bounces, suppression lists and webhooks. Delivery runs through Amazon SES. This script builds the web app and the SMTP proxy from source and runs them with PostgreSQL and Redis.
Site ↗ Documentation ↗ Dépôt de l'application ↗ Voir le code du script ↗
Installer
- Cœurs
- 2
- Mémoire
- 4 Go
- Disque
- 10 Go
- Système
- Debian 13
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/usesend.sh)"
Configuration : /opt/usesend_data/.env
Dans le shell du nœud Proxmox. Exécutez cette commande dans le shell du nœud Proxmox, pas dans une VM. Lisez le script d'abord.
Générateur : préparer la commande avec vos réglages
Remplissez seulement ce que vous voulez changer. Les valeurs vides gardent le réglage par défaut du script.
Tutoriel pas à pas
De l'interface de Proxmox jusqu'à la première connexion, pour useSend.
-
Ouvrez l'interface de Proxmox dans votre navigateur et connectez-vous.
-
Dans l'arbre de gauche, cliquez sur votre nœud, puis sur « Shell ».
-
Vérifiez que le nœud a la place pour ce conteneur : 2 cœurs, 4 Go de mémoire, 10 Go de disque.
-
Copiez cette commande, collez-la dans le shell et appuyez sur Entrée.
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/usesend.sh)" -
À la question « Use Default Settings? », répondez oui pour garder les réglages par défaut. Répondez non pour choisir vous-même l'identifiant, l'adresse, le disque ou le réseau.
-
Attendez la fin de l'installation : le script affiche l'adresse du conteneur.
-
Ouvrez
http://ADRESSE-IP:3000dans votre navigateur, en remplaçant ADRESSE-IP par l'adresse affichée. -
Pour entrer dans le conteneur : sélectionnez-le dans Proxmox, puis « Console ». La session
roots'ouvre sans mot de passe. -
Pour mettre à jour plus tard : tapez
updatedans la console du conteneur. -
Le fichier de configuration se trouve ici :
/opt/usesend_data/.env
À savoir
- The first sign-in creates the account, after that only email addresses with a team invitation can sign up. Until then anyone with a GitHub account who reaches the port can claim the instance, so sign in right after setting up OAuth.
- Sending needs Amazon SES. useSend installs and runs without it, but no email leaves until AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY of an IAM user with AmazonSESFullAccess and AmazonSNSFullAccess are set in /opt/usesend_data/.env and SES is added under Admin with a region and a callback URL. That URL must be reachable from the internet, because SNS posts delivery, bounce and complaint events to it. New SES accounts start in sandbox mode and only send to verified addresses.
- NEXTAUTH_URL in /opt/usesend_data/.env is http://<IP>:3000. Change it together with the OAuth callback URL when the IP changes or useSend runs behind a domain, then run systemctl restart usesend.
- Install and every update build useSend from source (Next.js), which takes about 15 minutes on 2 cores and needs the 4 GB of RAM. The running services use about 400 MB, so the RAM can be lowered after the install and raised again before an update.
Options propres à ce script
| Variable | Rôle | Type |
|---|---|---|
var_github_id | GitHub OAuth Client ID | text |
var_github_secret | GitHub OAuth Client Secret | password |
Notes de la version v1.9.8
What's Changed
- fix: prevent variable popover from blocking text selection by @Soumyaranjan-p in https://github.com/usesend/useSend/pull/448
- fix: derive SMTP proxy Bcc recipients from the envelope by @ntwcklng in https://github.com/usesend/useSend/pull/447
- fix: clear attachments and headers in the email cleanup job by @ntwcklng in https://github.com/usesend/useSend/pull/443
- fix: render text-only emails in the email preview by @ntwcklng in https://github.com/usesend/useSend/pull/44…
