Kolombo - CLI for easy mail server managing 💌
Project description
Kolombo
CLI for easy mail server managing 💌
NB! Work in progress, not ready for production use!
Introduction
What Kolombo does:
- Configures email domains (
example.com/mx.example.com
) and users (info@example.com
) - Generates DKIM keys with TXT records to add to DNS
- Manages all services needed for email to work in docker-compose
Installation
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 example.com
with user info@example.com
# 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 info@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
Project details
Release history Release notifications | RSS feed
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)
Built Distribution
kolombo-0.5.0-py3-none-any.whl
(31.8 kB
view hashes)