Update README.md
This commit is contained in:
parent
6265228b57
commit
1e6ef76203
56
README.md
56
README.md
|
@ -147,6 +147,62 @@ optional response body on subsequent lines. The bytes generated by the
|
||||||
CGI script will be forwarded *verbatim* to the gemini client, without any
|
CGI script will be forwarded *verbatim* to the gemini client, without any
|
||||||
additional modificiation by the server.
|
additional modificiation by the server.
|
||||||
|
|
||||||
|
## Example Configuration
|
||||||
|
|
||||||
|
Jetforce is intended to be run behind a process manager that handles
|
||||||
|
*daemonizing* the script, redirecting output to system logs, etc. I prefer
|
||||||
|
to use [systemd](https://www.freedesktop.org/wiki/Software/systemd/) for this
|
||||||
|
because it's installed on my operating system and easy to set up.
|
||||||
|
|
||||||
|
Here's how I configure my server over at **gemini://mozz.us**:
|
||||||
|
|
||||||
|
```
|
||||||
|
# /etc/systemd/system/jetforce.service
|
||||||
|
[Unit]
|
||||||
|
Description=Jetforce Server
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=simple
|
||||||
|
Restart=always
|
||||||
|
RestartSec=5
|
||||||
|
Environment="PYTHONUNBUFFERED=1"
|
||||||
|
ExecStart=/usr/local/bin/jetforce \
|
||||||
|
--host 0.0.0.0 \
|
||||||
|
--port 1965 \
|
||||||
|
--hostname mozz.us \
|
||||||
|
--dir /var/gemini \
|
||||||
|
--tls-certfile /etc/letsencrypt/live/mozz.us/fullchain.pem \
|
||||||
|
--tls-keyfile /etc/letsencrypt/live/mozz.us/privkey.pem \
|
||||||
|
--tls-cafile /etc/pki/tls/jetforce_client/ca.cer
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=default.target
|
||||||
|
```
|
||||||
|
|
||||||
|
- ``--host 0.0.0.0`` allows the server to accept external connections from any
|
||||||
|
IP address over IPv4.
|
||||||
|
- ``PYTHONUNBUFFERED=1`` disables buffering `stderr` and is sometimes necessary
|
||||||
|
for logging to work.
|
||||||
|
- ``--tls-certfile`` and ``--tls-keyfile`` point to my WWW server's Let's Encrypt
|
||||||
|
certificate chain.
|
||||||
|
- ``--tls-cafile`` points to a self-signed CA that I created in order to test
|
||||||
|
accepting client TLS connections.
|
||||||
|
|
||||||
|
With this service installed, I can start and stop the server using
|
||||||
|
|
||||||
|
```
|
||||||
|
systemctl start jetforce
|
||||||
|
systemctl stop jetforce
|
||||||
|
```
|
||||||
|
|
||||||
|
And I can view the server logs using
|
||||||
|
|
||||||
|
```
|
||||||
|
journalctl -u jetforce -f
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
This project is licensed under the [Floodgap Free Software License](https://www.floodgap.com/software/ffsl/license.html).
|
This project is licensed under the [Floodgap Free Software License](https://www.floodgap.com/software/ffsl/license.html).
|
||||||
|
|
Loading…
Reference in New Issue