History

Copyedit docs (#6275)

Aidan Fitzgerald committed 7 years ago

Commit f5cf9a81 parent 8fffb0628 files · +111 −111Browse files

Showing the changes to docs/content/doc/usage/https-support.md (1 of 28 files). Show all

Unified · Split

docs/content/doc/usage/https-support.md+8−8
@@ -15,12 +15,12 @@ menu: · 14 unmodified lines
15 15
16# HTTPS setup to encrypt connections to Gitea16# HTTPS setup to encrypt connections to Gitea
17 17
18## Using built-in server18 ## Using the built-in server
19 19
20Before you enable HTTPS make sure that you have valid SSL/TLS certificates.20Before you enable HTTPS, make sure that you have valid SSL/TLS certificates.
21You could use self-generated certificates for evaluation and testing. Please run `gitea cert --host [HOST]` to generate a self signed certificate.21You could use self-generated certificates for evaluation and testing. Please run `gitea cert --host [HOST]` to generate a self signed certificate.
22 22
23To use Gitea's built-in HTTPS support you must change your `app.ini` file:23To use Gitea's built-in HTTPS support, you must change your `app.ini` file:
24 24
25```ini25```ini
26[server]26[server]
@@ -33,7 +33,7 @@ KEY_FILE = key.pem · 6 unmodified lines
33 33
34To learn more about the config values, please checkout the [Config Cheat Sheet](../config-cheat-sheet#server).34To learn more about the config values, please checkout the [Config Cheat Sheet](../config-cheat-sheet#server).
35 35
36### Setting-up HTTP redirection36### Setting up HTTP redirection
37 37
38The Gitea server is only able to listen to one port; to redirect HTTP requests to the HTTPS port, you will need to enable the HTTP redirection service:38The Gitea server is only able to listen to one port; to redirect HTTP requests to the HTTPS port, you will need to enable the HTTP redirection service:
39 39
@@ -48,9 +48,9 @@ If you are using Docker, make sure that this port is configured in your `docker- · 8 unmodified lines
48 48
49## Using Let's Encrypt49## Using Let's Encrypt
50 50
51[Let's Encrypt](https://letsencrypt.org/) is a Certificate Authority that allows you to automatically request and renew SSL/TLS certificates. In addition to starting Gitea on your configured port, to request HTTPS certificates Gitea will also need to listed on port 80, and will set up an autoredirect to HTTPS for you. Let's Encrypt will need to be able to access Gitea via the Internet to verify your ownership of the domain.51[Let's Encrypt](https://letsencrypt.org/) is a Certificate Authority that allows you to automatically request and renew SSL/TLS certificates. In addition to starting Gitea on your configured port, to request HTTPS certificates, Gitea will also need to listed on port 80, and will set up an autoredirect to HTTPS for you. Let's Encrypt will need to be able to access Gitea via the Internet to verify your ownership of the domain.
52 52
53By using Lets Encrypt **you must consent** to their [terms of service](https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf)53By using Let's Encrypt **you must consent** to their [terms of service](https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf).
54 54
55```ini55```ini
56[server]56[server]
@@ -66,7 +66,7 @@ To learn more about the config values, please checkout the [Config Cheat Sheet]( · 9 unmodified lines
66 66
67## Using reverse proxy67## Using reverse proxy
68 68
69Setup up your reverse proxy like shown in the [reverse proxy guide](../reverse-proxies).69Setup up your reverse proxy as shown in the [reverse proxy guide](../reverse-proxies).
70 70
71After that, enable HTTPS by following one of these guides:71After that, enable HTTPS by following one of these guides:
72 72
@@ -74,5 +74,5 @@ After that, enable HTTPS by following one of these guides: · 1 unmodified line
74* [apache2/httpd](https://httpd.apache.org/docs/2.4/ssl/ssl_howto.html)74* [apache2/httpd](https://httpd.apache.org/docs/2.4/ssl/ssl_howto.html)
75* [caddy](https://caddyserver.com/docs/tls)75* [caddy](https://caddyserver.com/docs/tls)
76 76
77Note: Your connection between your reverse proxy and gitea might be unencrypted. To encrypt it too follow the [built-in server guide](#using-built-in-server) and change77Note: Your connection between your reverse proxy and Gitea might be unencrypted. To encrypt it too, follow the [built-in server guide](#using-built-in-server) and change
78the proxy url to `https://[URL]`.78the proxy url to `https://[URL]`.

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t