cdist-type__nginx(7)¶
NAME¶
cdist-type__nginx - Serve web content with NGINX
DESCRIPTION¶
Leverages __nginx_vhost to serve web content.
REQUIRED PARAMETERS¶
- domain
Domain name to be served.
OPTIONAL PARAMETERS¶
- config
Custom NGINX logic, templated within a standard server section with server_name and TLS parameters set. Defaults to simple static hosting.
- altdomains
Alternative domain names for this vhost and related TLS certificate.
- uacme-hookscript
Custom hook passed to the __uacme_obtain type: useful to integrate the dns-01 challenge with third-party DNS providers.
- acme-url
ACMEv2 server directory object URL. Lets’Encrypt is used by default.
- acme-eab-credentials
Specify RFC8555 External Account Binding credentials according to https://tools.ietf.org/html/rfc8555#section-7.3.4, in order to associate a new ACME account with an existing account in a non-ACME system such as a CA customer database. KEYID must be an ASCII string. KEY must be base64url-encoded.
EXAMPLES¶
# TLS-enabled vhost serving static files in $WEBROOT/domain.tld (OS-specific,
# usually `/var/www` on GNU/Linux systemd).
__nginx domain.tld
# TLS-enabled vhost with custom configuration.
__nginx files.domain.tld \
--config - <<- EOF
root /var/www/files.domain.tld/;
autoindex on;
EOF
COPYING¶
Copyright (C) 2020 Joachim Desroches. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.