Merge pull request #3682 from nunix/main

Added option E to docker single node install for 2.6
This commit is contained in:
Billy Tat
2021-11-18 09:28:14 -08:00
committed by GitHub
@@ -44,14 +44,13 @@ Choose from the following options:
- [Option B: Bring Your Own Certificate, Self-signed](#option-b-bring-your-own-certificate-self-signed)
- [Option C: Bring Your Own Certificate, Signed by a Recognized CA](#option-c-bring-your-own-certificate-signed-by-a-recognized-ca)
- [Option D: Let's Encrypt Certificate](#option-d-let-s-encrypt-certificate)
- [Option E: Localhost tunneling, no Certificate](#option-e-localhost-tunneling-no-certificate)
### Option A: Default Rancher-generated Self-signed Certificate
If you are installing Rancher in a development or testing environment where identity verification isn't a concern, install Rancher using the self-signed certificate that it generates. This installation option omits the hassle of generating a certificate yourself.
Log into your Linux host, and then run the minimum installation command below.
Privileged access is [required.](#privileged-access-for-rancher)
Log into your host, and run the command below:
```bash
docker run -d --restart=unless-stopped \
@@ -78,7 +77,7 @@ After creating your certificate, run the Docker command below to install Rancher
| `<PRIVATE_KEY.pem>` | The path to the private key for your certificate. |
| `<CA_CERTS.pem>` | The path to the certificate authority's certificate. |
Privileged access is [required.](#privileged-access-for-rancher)
Log into your host, and run the command below:
```bash
docker run -d --restart=unless-stopped \
@@ -110,7 +109,7 @@ After obtaining your certificate, run the Docker command below.
| `<FULL_CHAIN.pem>` | The path to your full certificate chain. |
| `<PRIVATE_KEY.pem>` | The path to the private key for your certificate. |
Privileged access is [required.](#privileged-access-for-rancher)
Log into your host, and run the command below:
```bash
docker run -d --restart=unless-stopped \
@@ -140,7 +139,7 @@ After you fulfill the prerequisites, you can install Rancher using a Let's Encry
| ----------------- | ------------------- |
| `<YOUR.DNS.NAME>` | Your domain address |
Privileged access is [required.](#privileged-access-for-rancher)
Log into your host, and run the command below:
```
docker run -d --restart=unless-stopped \
@@ -150,6 +149,22 @@ docker run -d --restart=unless-stopped \
--acme-domain <YOUR.DNS.NAME>
```
### Option E: Localhost tunneling, no Certificate
If you are installing Rancher in a development or testing environment where you have a localhost tunneling solution running, such as [ngrok](https://ngrok.com/), avoid generating a certificate. This installation option doesn't require a certificate.
- You will use `--no-cacerts` in the argument to disable the default CA certificate generated by Rancher.
Log into your host, and run the command below:
```bash
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
--privileged \
rancher/rancher:latest \
--no-cacerts
```
## Advanced Options
When installing Rancher on a single node with Docker, there are several advanced options that can be enabled: