2018-04-26 13:57:15 +02:00
|
|
|
# ee-acme-sh
|
2018-05-02 22:42:36 +02:00
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
## Bash script to install Let's Encrypt SSL certificates automatically using acme.sh on servers running with EasyEngine
|
2018-04-27 11:31:32 +02:00
|
|
|
|
2018-05-03 12:30:54 +02:00
|
|
|
![ee-acme-sh](https://raw.githubusercontent.com/VirtuBox/ee-acme-sh/master/ee-acme.png)
|
|
|
|
|
2018-05-02 22:42:36 +02:00
|
|
|
## Features
|
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
- Automated Installation of Let's Encrypt SSL certificates using [acme.sh](http://acme.sh)
|
|
|
|
- Acme validation with standalone mode or Cloudflare DNS API
|
|
|
|
- Domain, Subdomain & Wildcard SSL Certificates support
|
|
|
|
- IPv6 Support
|
|
|
|
- Generate ECDSA Certificates with ECC 384 Bits private key
|
|
|
|
- Automated Certificates Renewal
|
|
|
|
- Nginx mainline & stable release support
|
2018-09-25 18:52:53 +02:00
|
|
|
- Cert-only mode available
|
2018-05-02 22:42:36 +02:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
```bash
|
2018-09-25 18:52:53 +02:00
|
|
|
bash <(wget -qO - https://raw.githubusercontent.com/VirtuBox/ee-acme-sh/master/install.sh)
|
2018-05-02 22:42:36 +02:00
|
|
|
|
|
|
|
# enable acme.sh & ee-acme-sh
|
|
|
|
source .bashrc
|
|
|
|
```
|
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
## Update script
|
2018-05-02 22:42:36 +02:00
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
Just run the installation command again
|
2018-05-02 22:42:36 +02:00
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
## Usage
|
2018-05-02 22:42:36 +02:00
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
```bash
|
|
|
|
Usage: ee-acme [type] <domain> [mode]
|
2018-09-27 16:27:26 +02:00
|
|
|
Types:
|
|
|
|
-d, --domain <domain_name> ..... for domain.tld + www.domain.tld
|
|
|
|
-s, --subdomain <subdomain_name> ....... for sub.domain.tld
|
|
|
|
-w, --wildcard <domain_name> ..... for domain.tld + *.domain.tld
|
|
|
|
Modes:
|
|
|
|
--standalone ..... acme challenge in standalone mode
|
|
|
|
--cf ..... acme challenge in dns mode with Cloudflare
|
|
|
|
Options:
|
|
|
|
--cert-only ... do not change nginx configuration, only display it
|
|
|
|
--admin ... secure easyengine backend with the certificate
|
|
|
|
-h, --help, help ... displays this help information
|
|
|
|
Examples:
|
|
|
|
|
|
|
|
domain.tld + www.domain.tld in standalone mode :
|
|
|
|
ee-acme -d domain.tld --standalone
|
|
|
|
|
|
|
|
sub.domain.tld in dns mode with Cloudflare :
|
|
|
|
ee-acme -s sub.domain.tld --cf
|
|
|
|
|
|
|
|
wildcard certificate for domain.tld in dns mode with Cloudflare :
|
|
|
|
ee-acme -w domain.tld --cf
|
|
|
|
|
|
|
|
domain.tld + www.domain.tld in standalone mode without editing Nginx configuration :
|
|
|
|
ee-acme -d domain.tld --standalone --cert-only
|
|
|
|
|
|
|
|
sub.domain.tld in standalone mode to secure easyengine backend on port 22222 :
|
|
|
|
ee-acme -s sub.domain.tld --standalone --admin
|
2018-05-02 22:42:36 +02:00
|
|
|
```
|
2018-04-27 11:31:32 +02:00
|
|
|
|
2018-05-02 22:42:36 +02:00
|
|
|
## Limitations
|
2018-04-27 11:31:32 +02:00
|
|
|
|
2018-09-21 14:19:17 +02:00
|
|
|
- Wildcard certs are only available with Cloudflare DNS API
|