listmonk

A high-performance newsletter and mailing list manager with JumpCloud SSO support.

Overview

This repository is a fork of Listmonk⁠, the open-source, self-hosted newsletter and mailing list manager. This version has been enhanced with JumpCloud SSO (Single Sign-On) support, enabling organizations using JumpCloud to easily manage access to the Listmonk platform.

Listmonk is designed for high-performance email marketing campaigns, and this fork retains all of its powerful features while adding enterprise-grade authentication options.

Key Features

• 🌐 JumpCloud SSO Integration: Secure and seamless authentication using JumpCloud identity management.
• ✉️ Email Campaigns & Lists: Manage large-scale mailing lists with ease.
• ⚡ Performance-Driven: Built to handle high-throughput email campaigns efficiently.
• 🛠️ Customizable: Extend or tweak functionality based on your organization’s needs.
• 🐳 Docker Support: Includes prebuilt Docker images for easy deployment.

Getting Started

Prerequisites

• Docker (recommended for deployment)
• JumpCloud account for SSO configuration

Installation

Docker

The latest image is available on DockerHub at gofirmex/listmonk:latest. Use the sample docker-compose.yml provided in this repository to run the container manually, or use the helper script for easier setup.

Configure JumpCloud SSO

Once the project is installed and running, follow these steps to configure JumpCloud SSO:

1. Navigate to Settings -> Security in the Listmonk admin panel.
2. Enable the option 'Enable OIDC SSO'.
3. Set the Provider URL to: https://oauth.id.jumpcloud.com/⁠
4. Enter your Client ID and Client Secret provided by JumpCloud.

After saving these changes, your Listmonk instance will be ready to authenticate users via JumpCloud SSO.