diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml new file mode 100644 index 0000000..5e3d9ca --- /dev/null +++ b/.github/FUNDING.yml @@ -0,0 +1,3 @@ +--- +github: [cytopia] +patreon: devilbox diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..180ae53 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,106 @@ +--- +name: "\U0001F41B Bug report" +description: File a bug report +title: "[Bug]: " +labels: ["bug", "status:triage"] +assignees: + - cytopia + +body: + + - type: markdown + attributes: + value: | + Thanks for taking the time to fill out this bug report! + + - type: input + attributes: + label: (Optional) Error message + description: If you encountered any error message, copy and paste it here. This will be used for googling the issue. + validations: + required: false + + - type: textarea + id: what-happened + attributes: + label: What went wrong? + description: What exactly went wrong and what bug did you encounter? + validations: + required: true + + - type: textarea + id: expected-behaviour + attributes: + label: Expected behaviour + description: What did you expect to happen instead? + validations: + required: true + + - type: textarea + id: steps-to-reproduce + attributes: + label: How can we reproduce the bug? + description: How do you trigger this bug? Please walk us through it step by step in detail. This is crucial in order to triage the bug and support you in resolving it. + validations: + required: true + + - type: dropdown + id: host-os + attributes: + label: Host Operating System + description: What operating system are you using? + multiple: false + options: + - Linux + - macOS + - Windows + validations: + required: true + + - type: dropdown + id: host-platform + attributes: + label: Host Platform (amd64, arm64, other) + description: What host platform are you running on? + options: + - amd64 + - arm64 + - other + validations: + required: true + + - type: dropdown + attributes: + label: (Linux only) Is SELinux enabled? + description: When using Linux as your host operating system, check if SELinux is enabled or not. + options: + - Yes, SELinux is enabled + - No, SELinux is disabled + - I don't know + - I am not on Linux + validations: + required: true + + - type: input + id: docker-version + attributes: + label: Docker version + description: "What Docker version are you using? Please copy and paste the output of `docker --version` into this text area." + validations: + required: true + + - type: textarea + id: log-docker + attributes: + label: "Log: docker logs" + description: "Please copy and paste the output of `docker logs` into this text area" + render: shell + validations: + required: true + + - type: textarea + attributes: + label: (Optional) Additional information + description: Add any additional information that might help with this bug report. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..9f2ad11 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,12 @@ +--- +blank_issues_enabled: false +contact_links: + - name: Devilbox Discord Chat + url: https://discord.gg/2wP3V6kBj4 + about: Please notify or discuss about any other requests here. + - name: Devilbox Discourse Forum + url: https://devilbox.discourse.group/ + about: Please ask and answer general questions here. + - name: Devilbox documentation + url: https://devilbox.readthedocs.io/ + about: Find the Devilbox documentation here. diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml new file mode 100644 index 0000000..b0e2a11 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -0,0 +1,37 @@ +--- +name: "\U0001F4DD Documentation" +description: Something is missing, unclear or wrong in the documentation. +title: "[Docs]: " +labels: ["documentation", "status:triage"] +assignees: + - cytopia + +body: + + - type: textarea + attributes: + label: What is wrong in the documentation? + description: Tell us, what is wrong in the documentation? + validations: + required: false + + - type: textarea + attributes: + label: What is unclear in the documentation? + description: Tell us, what is unclear in the documentation? + validations: + required: false + + - type: textarea + attributes: + label: What is missing in the documentation? + description: Tell us, what is missing in the documentation? + validations: + required: false + + - type: dropdown + attributes: + label: Are you willing to provide a PR to address this? + options: + - "Yes" + - "No" diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..a4706bf --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,36 @@ +--- +name: "โœจ Feature request" +description: Suggest an idea or feature for this project +title: "[Feature]: " +labels: ["feature", "status:triage"] +assignees: [cytopia] + +body: + + - type: textarea + attributes: + label: What is your idea or feature suggestion? + description: Tell us, what idea or feature you suggest to be added. + validations: + required: true + + - type: textarea + attributes: + label: Benefits + description: Tell us, how this will be beneficial. + validations: + required: false + + - type: textarea + attributes: + label: Where can we find information about this? + description: If you are proposing a software or tool, please add relevant links and documentation. + validations: + required: false + + - type: dropdown + attributes: + label: Are you willing to provide a PR to address this? + options: + - "Yes" + - "No" diff --git a/.github/ISSUE_TEMPLATE/howto.yml b/.github/ISSUE_TEMPLATE/howto.yml new file mode 100644 index 0000000..823af05 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/howto.yml @@ -0,0 +1,45 @@ +--- +name: "โ” Question" +description: How do I do X or Y? +title: "[Question]: " +labels: ["question", "status:triage"] +assignees: [cytopia] + +body: + + - type: markdown + attributes: + value: | + If this is a generic question, please consider using the [Discord Chat](https://discord.gg/2wP3V6kBj4) or the [Devilbox forum](https://devilbox.discourse.group/) instead. + + - type: checkboxes + attributes: + label: Have you already checked elsewhere? + description: You may select more than one. + options: + - label: I have checked existing issues + - label: I have googled already with no luck + - label: I have not done any of the above + validations: + required: true + + - type: textarea + attributes: + label: What is your question? + description: Tell the community, what your question is. Be as specific as possible to make it easier for other people to answer your question. + validations: + required: true + + - type: textarea + attributes: + label: What have you tried already? + description: Add some details on what you have tried already, so this can be ruled out. + validations: + required: true + + - type: textarea + attributes: + label: What is your goal? + description: Tell the community, what you want to accomplish? This might be helpful to know in order to prevent [XY problems](https://en.wikipedia.org/wiki/XY_problem). + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/report.yml b/.github/ISSUE_TEMPLATE/report.yml new file mode 100644 index 0000000..36381de --- /dev/null +++ b/.github/ISSUE_TEMPLATE/report.yml @@ -0,0 +1,21 @@ +--- +name: "๐Ÿ•ฌ Report" +description: Report something to the maintainer +title: "[Report]: " +labels: ["report", "status:triage"] +assignees: + - cytopia + +body: + + - type: markdown + attributes: + value: | + Report something to the maintainer such as versions are outdated or pipelines are not running, etc. For anything else please use other issue types. Thanks for taking the time! + + - type: textarea + attributes: + label: Report + description: What do you want to report? + validations: + required: true diff --git a/.github/labels.yml b/.github/labels.yml index 18c2cd2..f4d5b48 100644 --- a/.github/labels.yml +++ b/.github/labels.yml @@ -1,7 +1,9 @@ # The labels in this file are automatically synced with the repository # using the micnncim/action-label-syncer action. --- -# Dependabot +### +### Pull Requests (Dependabot) +### - name: C-dependency color: 1abc9c description: "Category: Dependency" @@ -11,13 +13,105 @@ - name: PR-merge color: 3498db description: "Pull Request: Merge when ready" -# Release Drafter + +### +### Pull Requests (Release Drafter) +### - name: major color: 1abc9c - description: "Make Release drafter create a new major release" + description: "Create major release" - name: minor color: 3498db - description: "Make Release drafter create a new minor release" + description: "Create minor release" - name: patch color: 3498db - description: "Make Release drafter create a new patch release" + description: "Create patch release" + +### +### General Issues +### +- name: bug + description: "Bug Report" + color: ee0701 +- name: report + description: "General Report" + color: ef561f +- name: feature + description: "Feature Request" + color: dc8b10 +- name: question + description: "General question" + color: cc317c +- name: documentation + description: "Documentation related" + color: 45b046 + +### +### Status: Issue progress +### +- name: "status:triage" + description: "Issue needs Triaging" + color: f2a7cf +- name: "status:confirmed" + description: "Issue is confirmed" + color: f2a7cf +- name: "status:needs-more-info" + description: "Issue needs more info" + color: f2a7cf + +### +### Close +### +- name: "issue:invalid" + description: "" + color: f5c7fc +- name: "issue:invalid-type" + description: "" + color: f5c7fc +- name: "issue:duplicate" + description: "" + color: f5c7fc +- name: "issue:wontfix" + description: "" + color: f5c7fc +- name: "issue:stale" + description: "" + color: f5c7fc + +### +### Issue types +### +- name: "type:extension" + description: "" + color: 0c9cf2 +- name: "type:tool" + description: "" + color: 0c9cf2 +- name: "type:env-var" + description: "" + color: 0c9cf2 +- name: "type:config" + description: "" + color: 0c9cf2 + +### +### Issue Host specific +### +- name: "host:linux" + description: "" + color: fbca04 +- name: "host:macos" + description: "" + color: fbca04 +- name: "host:windows" + description: "" + color: fbca04 +- name: "arch:amd64" + description: "" + color: fbca04 +- name: "arch:arm64" + description: "" + color: fbca04 +- name: "arch:other" + description: "" + color: fbca04 diff --git a/Makefile b/Makefile index 758045a..79f5145 100644 --- a/Makefile +++ b/Makefile @@ -93,16 +93,7 @@ manifest-push: docker-manifest-push DEBUG = 0 .PHONY: test test: _test-integration -test: update-readme .PHONY: _test-integration _test-integration: ./tests/start-ci.sh $(IMAGE) $(NAME) $(VERSION) $(DOCKER_TAG) $(ARCH) $(DEBUG) - -.PHONY: update-readme -update-readme: - cat "./README.md" \ - | perl -0 -pe "s/.*/\n$$(./tests/get-modules.sh $(IMAGE) $(NAME) $(VERSION) $(DOCKER_TAG) $(ARCH))\n/s" \ - > "./README.md.tmp" - yes | mv -f "./README.md.tmp" "./README.md" - git diff --quiet || { echo "Build Changes"; git diff; git status; false; } diff --git a/README.md b/README.md index 657f1c3..c902b35 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,38 @@ # Bind Docker - [![Tag](https://img.shields.io/github/tag/cytopia/docker-bind.svg)](https://github.com/cytopia/docker-bind/releases) [![lint](https://github.com/cytopia/docker-bind/workflows/lint/badge.svg)](https://github.com/cytopia/docker-bind/actions?query=workflow%3Alint) [![build](https://github.com/cytopia/docker-bind/workflows/build/badge.svg)](https://github.com/cytopia/docker-bind/actions?query=workflow%3Abuild) [![nightly](https://github.com/cytopia/docker-bind/workflows/nightly/badge.svg)](https://github.com/cytopia/docker-bind/actions?query=workflow%3Anightly) -[![Gitter](https://badges.gitter.im/cytopia/Lobby.svg)](https://gitter.im/cytopia/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) -[![Discourse](https://img.shields.io/discourse/https/devilbox.discourse.group/status.svg?colorB=%234CB697)](https://devilbox.discourse.group) [![License](https://img.shields.io/badge/license-MIT-%233DA639.svg)](https://opensource.org/licenses/MIT) -Bind caching DNS server based on Alpine and Debian slim with support for DNS forwarders, infinite wild-card DNS, infinite extra hosts, reverse DNS, DNSSEC timing settings and others. +[![Discord](https://img.shields.io/discord/1051541389256704091?color=8c9eff&label=Discord&logo=discord)](https://discord.gg/2wP3V6kBj4) +[![Discourse](https://img.shields.io/discourse/https/devilbox.discourse.group/status.svg?colorB=%234CB697&label=Discourse&logo=discourse)](https://devilbox.discourse.group) + +**Available Architectures:** `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` [![](https://img.shields.io/docker/pulls/cytopia/bind.svg)](https://hub.docker.com/r/cytopia/bind) -[![Docker](https://badgen.net/badge/icon/:latest?icon=docker&label=cytopia/bind)](https://hub.docker.com/r/cytopia/bind) -**Available Architectures:** `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` +Bind caching DNS server based on Alpine and Debian slim with support for DNS forwarders, infinite wild-card DNS, infinite extra hosts, reverse DNS, DNSSEC timing settings and others. + +| Bind Project | Reference Implementation | +|:-------------------:|:------------------------:| +| | | +| [Bind DNS Server](https://github.com/cytopia/docker-bind) | The [Devilbox](https://github.com/cytopia/devilbox) | + -| Upstream Project | -|------------------| -| | +## ๐Ÿ‹ Available Docker tags +[![](https://img.shields.io/docker/pulls/cytopia/bind.svg)](https://hub.docker.com/r/cytopia/bind) + +[`latest`][tag_latest] [`stable`][tag_stable] [`alpine`][tag_alpine] +```bash +docker pull cytopia/bind +``` -## :whale: Available Docker tags +[tag_latest]: Dockerfiles/Dockerfile.latest +[tag_stable]: Dockerfiles/Dockerfile.stable +[tag_alpine]: Dockerfiles/Dockerfile.alpine #### Rolling Releases @@ -29,13 +40,11 @@ The following Docker image tags are rolling releases and are built and updated e [![nightly](https://github.com/cytopia/docker-bind/workflows/nightly/badge.svg)](https://github.com/cytopia/docker-bind/actions?query=workflow%3Anightly) -| Debian stable | Alpine | -|---------------|--------| -| [`latest`](Dockerfiles/Dockerfile.latest) [`stable`](Dockerfiles/Dockerfile.stable)
[`latest-`](Dockerfiles/Dockerfile.latest) [`stable-`](Dockerfiles/Dockerfile.stable) | [`alpine`](Dockerfiles/Dockerfile.alpine)
[`alpine-`](Dockerfiles/Dockerfile.alpine) | - -> :information_source: Where `` refers to the latest git tag from this repository.
-> :information_source: Note: Only the latest git tag is build nightly, all others remain unchaned. - +| Docker Tag | Git Ref | Available Architectures | +|----------------------------------|--------------|------------------------------------------------------------------------------| +| **[`latest`][tag_latest]** | master | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | +| [`stable`][tag_stable] | master | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | +| [`alpine`][tag_alpine] | master | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | #### Point in time releases @@ -43,19 +52,23 @@ The following Docker image tags are built once and can be used for reproducible [![build](https://github.com/cytopia/docker-bind/workflows/build/badge.svg)](https://github.com/cytopia/docker-bind/actions?query=workflow%3Abuild) -| Debian stable | Alpine | -|---------------|--------| -| [`latest-`](Dockerfiles/Dockerfile.latest) [`stable-`](Dockerfiles/Dockerfile.stable) | [`alpine-`](Dockerfiles/Dockerfile.alpine) | +| Docker Tag | Git Ref | Available Architectures | +|----------------------------------|--------------|-------------------------------------------------------------------------------| +| **[``][tag_latest]** | git: `` | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | +| [`-stable`][tag_stable] | git: `` | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | +| [`-alpine`][tag_alpine] | git: `` | `amd64`, `i386`, `arm64`, `arm/v7`, `arm/v6`, `ppc64le`, `s390x`, `mips64le` | + +> ๐Ÿ›ˆ Where `` refers to the chosen git tag from this repository.
+> โš  **Warning:** The latest available git tag is also build every night and considered a rolling tag. -> :information_source: Where `` refers to the chosen git tag from this repository.
---- **Table of Contents** -1. [Environmental variables](#capital_abcd-environmental-variables) - 1. [Required environmental variables](#required-environmental-variables) - 2. [Optional environmental variables](#optional-environmental-variables) +1. [Environment variables](#-environment-variables) + 1. [Required environment variables](#required-environment-variables) + 2. [Optional environment variables](#optional-environment-variables) 1. [DEBUG_ENTRYPOINT](#debug_entrypoint) 2. [DOCKER_LOGS](#docker_logs) 3. [DNS_A](#dns_a) @@ -71,9 +84,9 @@ The following Docker image tags are built once and can be used for reproducible 13. [MAX_CACHE_TIME](#max_cache_time) 14. [ALLOW_QUERY](#allow_query) 15. [ALLOW_RECURSION](#allow_recursion) -2. [Default mountpoints](#open_file_folder-default-mount-points) -3. [Default ports](#calling-default-ports) -4. [Examples](#information_source-examples) +2. [Volumes](#-volumes) +3. [Exposed Ports](#-exposed-ports) +4. [Examples](#-examples) 1. [Default run](#default-run) 2. [Wildcard domain](#wildcard-domain) 3. [Wildcard subdomain](#wildcard-subdomain) @@ -82,20 +95,23 @@ The following Docker image tags are built once and can be used for reproducible 6. [Wildcard TLD and DNS resolver](#wildcard-tld-and-dns-resolver) 7. [Wildcard TLD, DNS resolver and extra hosts](#wildcard-tld-dns-resolver-and-extra-hosts) 8. [Extra hosts, DNS resolver, allow query, and allow recursion](#extra-hosts-dns-resolver-allow-query-and-allow-recursion) -5. [Host integration](#wrench-host-integration) -6. [Support](#coffee-support) -7. [Articles](#page_with_curl-articles) -8. [License](#page_facing_up-license) +5. [Host integration](#-host-integration) +6. [Sister Projects](#-sister-projects) +7. [Community](#-community) +8. [Articles](#-articles) +9. [Credits](#-credits) +10. [Maintainer](#-maintainer) +11. [License](#-license) --- -## :capital_abcd: Environmental variables +## โˆ‘ Environment Variables -### Required environmental variables +### Required environment variables - None -### Optional environmental variables +### Optional environment variables | Variable | Type | Default | Description | |--------------------|--------|-----------|-------------| @@ -275,12 +291,12 @@ ALLOW_RECURSION='any' ALLOW_RECURSION='192.168.1.0/24,127.0.0.1' ``` -## :open_file_folder: Default mount points +## ๐Ÿ“‚ Volumes - None -## :calling: Default ports +## ๐Ÿ–ง Exposed Ports | Docker | Description | |--------|--------------| @@ -288,7 +304,7 @@ ALLOW_RECURSION='192.168.1.0/24,127.0.0.1' | 53/udp | DNS Resolver | -## :information_source: Examples +## ๐Ÿ’ก Examples The following examples start the container in foreground and use `-i`, so you can easily stop it by pressing ` + c`. For a production run, you would rather use `-d` to send it to the @@ -298,7 +314,7 @@ background. Exposing the port is mandatory if you want to use it for your host operating system. ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -t cytopia/bind @@ -309,7 +325,7 @@ $ docker run -i \ Let's add a wildcard zone for `*.example.com`. All subdomains (but not example.com itself) will resolve to `192.168.0.1`. ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.example.com=192.168.0.1' \ @@ -321,7 +337,7 @@ $ docker run -i \ Let's add a wildcard zone for `*.aws.example.com`. All subdomains (but not aws.example.com itself) will resolve to `192.168.0.1`. ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.aws.example.com=192.168.0.1' \ @@ -333,7 +349,7 @@ $ docker run -i \ Let's add a wildcard zone for `*.loc`. All domains, subdomain (but not loc itself) will resolve to `192.168.0.4`. ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.loc=192.168.0.4' \ @@ -345,7 +361,7 @@ $ docker run -i \ Let's add a wildcard zone for `*.loc`, and an A record for loc. All domains, subdomain and loc itself will resolve to `192.168.0.4`. Additionally we specify that `host.loc` will be the reverse loopup for `192.168.0.4`. ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.loc=192.168.0.4, loc=192.168.0.4' \ @@ -365,7 +381,7 @@ any already defined custom DNS entries by that nameserver. * Your corporate DNS servers are `10.0.15.1` and `10.0.15.2` ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.loc=192.168.0.1' \ @@ -382,7 +398,7 @@ $ docker run -i \ - host5.org -> 192.168.0.3 ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='*.loc=192.168.0.1, host5.loc=192.168.0.2, host5.org=192.168.0.3' \ @@ -404,7 +420,7 @@ $ docker run -i \ - host1 -> 192.168.0.11 ```bash -$ docker run -i \ +docker run -i \ -p 53:53/tcp \ -p 53:53/udp \ -e DNS_A='host1=192.168.0.11' \ @@ -414,7 +430,7 @@ $ docker run -i \ -t cytopia/bind ``` -## :wrench: Host integration +## ๐Ÿ”ง Host integration You can run this DNS container locally without having to worry to affect any corporate DNS server that are given to you via DHCP. @@ -426,10 +442,10 @@ prepend domain-name-servers 127.0.0.1; Restart network manager ```bash # Via service command -$ sudo service network-manager restart +sudo service network-manager restart # Or the systemd way -$ sudo systemctl restart network-manager +sudo systemctl restart network-manager ``` This will make sure that whenever your `/etc/resolv.conf` is deployed, you will have `127.0.0.1` @@ -439,44 +455,135 @@ If `cytopia/bind` is not running, it does not affect the name resolution, becaus have entries in `/etc/resolv.conf`. -## :coffee: Support +## ๐Ÿ–ค Sister Projects + +Show some love for the following sister projects. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
๐Ÿ–ค Project๐Ÿฑ GitHub๐Ÿ‹ DockerHub
Devilbox
docker-php-fpmdevilbox/php-fpm
docker-php-fpm-communitydevilbox/php-fpm-community
docker-mysqldevilbox/mysql
+ docker-apache-2.2
+ docker-apache-2.4
+ docker-nginx-stable
+ docker-nginx-mainline + 		+ devilbox/apache-2.2
+ devilbox/apache-2.4
+ devilbox/nginx-stable
+ devilbox/nginx-mainline +
docker-bindcytopia/bind
+ + +## ๐Ÿ‘ซ Community -Get support here +In case you seek help, go and visit the community pages. - - + + + + - + +

Chat

Forum

๐Ÿ“˜ Documentation

๐ŸŽฎ Discord

๐Ÿ—ช Forum
- - + + + + + + - +
gitter.im/devilboxdevilbox.readthedocs.iodiscord/devilbox devilbox.discourse.group
-## :page_with_curl: Articles +## ๐Ÿ“œ Articles * [Serving Bind DNS in Kubernetes](https://medium.com/swlh/serving-bind-dns-in-kubernetes-8639fce37448) -## :page_facing_up: License +## โค๏ธ Credits + +Thanks for contributing ๐Ÿ–ค + +- **[@atomicbaum1](https://github.com/atomicbaum1)** +- **[@ericp-mrel](https://github.com/ericp-mrel)** +- **[@Zighy](https://github.com/Zighy)** + + +## ๐Ÿง˜ Maintainer + +**[@cytopia](https://github.com/cytopia)** + +I try to keep up with literally **over 100 projects** besides a full-time job. +If my work is making your life easier, consider contributing. ๐Ÿ–ค + +* [GitHub Sponsorship](https://github.com/sponsors/cytopia) +* [Patreon](https://www.patreon.com/devilbox) +* [Open Collective](https://opencollective.com/devilbox) + +**Findme:** +**๐Ÿฑ** [cytopia](https://github.com/cytopia) / [devilbox](https://github.com/devilbox) | +**๐Ÿ‹** [cytopia](https://hub.docker.com/r/cytopia/) / [devilbox](https://hub.docker.com/r/devilbox/) | +**๐Ÿฆ** [everythingcli](https://twitter.com/everythingcli) / [devilbox](https://twitter.com/devilbox) | +**๐Ÿ“–** [everythingcli.org](http://www.everythingcli.org/) + +**Contrib:** PyPI: [cytopia](https://pypi.org/user/cytopia/) **ยท** +Terraform: [cytopia](https://registry.terraform.io/namespaces/cytopia) **ยท** +Ansible: [cytopia](https://galaxy.ansible.com/cytopia) + + +## ๐Ÿ—Ž License **[MIT License](LICENSE.md)**