{"id":23916800,"url":"https://github.com/zion-networks/mailcow-tools","last_synced_at":"2025-02-23T19:43:12.666Z","repository":{"id":269450340,"uuid":"907454758","full_name":"zion-networks/mailcow-tools","owner":"zion-networks","description":"Manage Mailcow instances via CLI","archived":false,"fork":false,"pushed_at":"2025-02-10T11:32:55.000Z","size":45,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-10T12:32:03.236Z","etag":null,"topics":["administration","cli","mailcow","mailcow-dockerized","mailserver","tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zion-networks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-23T16:08:25.000Z","updated_at":"2025-02-10T11:32:58.000Z","dependencies_parsed_at":"2024-12-23T17:22:51.024Z","dependency_job_id":"99708975-17f0-44b0-b3a4-f040b2c21a52","html_url":"https://github.com/zion-networks/mailcow-tools","commit_stats":null,"previous_names":["zion-networks/mailcow-tools"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zion-networks%2Fmailcow-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zion-networks%2Fmailcow-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zion-networks%2Fmailcow-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zion-networks%2Fmailcow-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zion-networks","download_url":"https://codeload.github.com/zion-networks/mailcow-tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240371743,"owners_count":19790888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["administration","cli","mailcow","mailcow-dockerized","mailserver","tools"],"created_at":"2025-01-05T12:14:22.468Z","updated_at":"2025-02-23T19:43:12.636Z","avatar_url":"https://github.com/zion-networks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mailcow Tools\n\n\u003e [!NOTE]\n\u003e Mailcow Tools is still in very early development. A lot of features are still missing and the code structure is not final at all.\n\n[Mailcow]([https://](https://mailcow.email/)) is a great option to run your very own mailserver. It comes with tons of features and one of them is the [REST API](https://mailcow.docs.apiary.io). The API is the counterpart of this tool.\n\nMailcow Tools allows you to manage any Mailcow instance right from the terminal. But it does not just map the REST routes to commands - it also comes with some handy additions, like batch creation of mailboxes.\n\n### Getting started\n\n1. Clone this repository: `git clone git@github.com:zion-networks/mailcow-tools.git`\n2. Move to the directory: `cd mailcow-tools`\n3. Make it a venv: `python3 -m venv .`\n4. Activate the venv: `source bin/activate`\n5. Install the required packages `pip install -r requirements.txt`\n6. (Optional) Enable bash autocompletion: `source bash_autocomplete.sh`\n7. Use it: `./mailcow-tools.sh help`\n\n### Environment Variables\n\nYou can either create a `.env` file or use global environment variables. Currently, Mailcow Tools knows these environment variables:\n\n- MAILCOW_TOOLS_MAILCOW_API_KEY=place-your-api-key-here (you can get your API key from your Mailcow web interface: https://mail.mymailcowhost.tld/admin)\n- MAILCOW_TOOLS_MAILCOW_HOST=mail.mymailcowhost.tld\n- MAILCOW_TOOLS_VALIDATE_CERTIFICATE=true (only use `false` if you really know, what you do)\n- MAILCOW_TOOLS_LOG_LEVEL=INFO (Supported: `DEBUG`, `INFO`, `WARNING`, `ERROR`)\n\nThe `help` command will list you all available modules. Using `./mailcow-tools.sh help \u003cmodule\u003e` you can also see the help for a specific module.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzion-networks%2Fmailcow-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzion-networks%2Fmailcow-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzion-networks%2Fmailcow-tools/lists"}