Skip to main content

Kolombo - CLI for easy mail server managing 💌

Project description


Kolombo Logo

CLI for easy mail server managing 💌

NB! Work in progress, not ready for production use!


What Kolombo does:

  • Configures email domains ( and users (
  • Generates DKIM keys with TXT records to add to DNS
  • Manages all services needed for email to work in docker-compose


Python 3.8+, sudo, Docker and docker-compose should be installed on system.

Install with pip:

pip install kolombo

How to use

Documentation is coming, for now, this is how to setup mail server for domain with user

# Initialize Kolombo
kolombo init

# Add domain and generate DKIM keys for it
kolombo domain add  # MX field is optional
kolombo dkim generate  # generates DKIM keys and returns DNS TXT record to add
kolombo dkim txt  # returns DNS TXT record to add

# Add user (email) for domain you just added
kolombo user add

# Deploy Kolombo services and senders one by one...
kolombo run receiver  # Listens on 25 for incoming mail, gives emails to users that come through nginx 993/995 ports
kolombo run auth  # Authenticates SMTP/POP3/IMAP users from nginx
kolombo run nginx  # Listens on 465 (SMTP), 993 (IMAP) and 995 (POP3)
kolombo run senders  # Send emails from users that come through nginx 465 port

# ... or deploy all everything at once
kolombo run all

# Stop all Kolombo services and senders
kolombo stop all

# ... or stop them one by one
kolombo stop receiver
kolombo stop auth
kolombo stop nginx
kolombo stop senders

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kolombo-0.5.0.tar.gz (39.4 kB view hashes)

Uploaded source

Built Distribution

kolombo-0.5.0-py3-none-any.whl (31.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page