mccs
EN
GitHub Install
MIT, no paid editionOne Docker container

Walk your users through setting up their mail

mccs (Mail, Calendar, Contacts Setup) is a web page you host for the customers of your mail service. They type their address, pick Windows, macOS, iPhone, iPad or Android, and get a short guide with every value ready to copy.

InstallRead the docs
jane.doe@example.com
GuidesNew Outlook, classic Outlook, CalDAV Synchronizer, Thunderbird
IMAPmail.example.com, 993, SSL/TLS
SMTPmail.example.com, 465, SSL/TLS
PasswordNever asked, never stored

One step per screen, with every value ready to copy.

How it works

An address, a device, an app, a guide.

  1. Address

    The customer types their address, or opens a link you prepared.

  2. Device

    Windows, macOS, iPhone, iPad or Android.

  3. App

    The guides on offer depend on the device.

  4. Guide

    One step per screen, with every value ready to copy.

See all features

Limits

Read this before you deploy it.

  • French only

    The interface and the guides are in French. Translating means editing the files by hand.

  • Unsigned Apple profile

    iOS and macOS show "Not signed" when installing it, and the server does not sign it for you.

  • No published image

    Docker builds it from the repository. There are no automated tests and no CI yet.

  • Written for MDaemon

    The guides were written for one MDaemon instance. The generic preset has had less use.

  • It does not check your servers

    The settings are only as right as your configuration. A new version of Outlook or Thunderbird can make a step out of date.

What it does not do

Get mccs running

Open http://localhost:8080 and try the wizard with an address on your domain. Details are in the docs.

InstallRead the docs
$ git clone https://github.com/yetysw/mccs.git && cd mccs
$ cp .env.example .env  # set MAIL_HOST, PUBLIC_URL, BRAND_NAME
$ docker compose up -d --build