Skip to main content

Get Started with Your Newsletter

Four simple steps to deploy your self-hosted newsletter. Takes about 5 minutes.

Create a free account

30 seconds

Sign up with Google, GitHub, or email. No credit card required.

Install the CLI and deploy

2 minutes

Install the Codehooks CLI and deploy your self-hosted newsletter platform.

npm install -g codehooks
coho create mynewsletter --template email-newsletter
cd mynewsletter && npm install && coho deploy

Configure provider and admin access

2 minutes

Set your Mailgun (or Brevo) API key, plus a JWT secret and admin password for the admin UI.

coho set-env MAILGUN_API_KEY 'key-xxxxxxxx' --encrypted
coho set-env MAILGUN_DOMAIN 'mg.yourdomain.com'
coho set-env JWT_SECRET "$(openssl rand -hex 32)" --encrypted
coho set-env ADMIN_PASSWORD 'choose-a-strong-password' --encrypted

Open the admin UI and collect subscribers

Done!

Open /admin.html, log in, create a list, then point your signup form at POST /subscribe.

Prefer Brevo? Set EMAIL_PROVIDER=brevo and BREVO_API_KEY instead of the Mailgun variables. Everything else stays the same.

Ready to start?

Create your free account to get your API keys and start deploying.

Create Free Account

No credit card required. Free tier includes 500 API calls/day.

What's included in your newsletter platform:

Double opt-inNo-code admin UIMarkdown composerBulk list importFull source code