Manage your Web domains served by NGINX
Project description
webdomains
Manage your Web domains served by NGINX.
Installation
Requirements
On a Debian-based host, you will need an already configured and running NGINX server. You may also install the following packages to satisfy the Python dependencies:
python3-click
python3-jinja2
To generate the SSL/TLS certificates for the domains, you will also have to
install and configure dehydrated. It is recommended
to use a recent version - i.e. from buster-backports
. To serve the ACME
challenge, the default NGINX configuration of a domain is looking for
/etc/nginx/snippets/acme-challenge.conf
- which can just contain:
location /.well-known/acme-challenge {
default_type "text/plain";
alias /var/lib/dehydrated/acme-challenges;
}
Configuration
You can provide your own server.conf
template which is used to generate the
NGINX configuration of a new domain. webdomains will look for a file with this
name in /etc/webdomains/templates
at first. If it does not exist, the
default template is used.
Development
To set up a development environment, all you need to have to install is a Python 3 interpreter, Git and Make. Then, run the following:
git clone https://framagit.org/cliss21/webdomains.git
cd webdomains/
# create and active a virtual environment
python3 -m venv venv/
source venv/bin/activate
# install the package with test requirements
pip install --editable ".[dev]"
You can now run the following commands:
make lint
: check the code syntaxmake test
: run the testsmake coverage
: report the code coverage
License
webdomains is mainly developed by Cliss XXI and licensed under the GPLv3+. Any contribution is welcome!
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
Built Distribution
Hashes for webdomains-1.0.0b3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c218c5dfccb5deda3d752fae90381248e04f33ed17e4f0c0e898305b77b0cef |
|
MD5 | d6823e84410e8cb2e9265f4e8679d4dd |
|
BLAKE2b-256 | e3f369c20a9e9deeedf941edfc418577bc82ccf0463dad7f0d4f89f4f379d38d |