Kolombo - CLI for easy mail server managing 💌
CLI for easy mail server managing 💌
NB! Work in progress, not ready for production use!
What Kolombo does:
- Configures email domains (
example.com/mx.example.com) 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
example.com with user
# Initialize Kolombo kolombo init # Add domain and generate DKIM keys for it kolombo domain add example.com mx.example.com # MX field is optional kolombo dkim generate example.com # generates DKIM keys and returns DNS TXT record to add kolombo dkim txt example.com # returns DNS TXT record to add # Add user (email) for domain you just added kolombo user add email@example.com # 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
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.