master
nova 4 years ago
parent
commit
c0966e74a0
  1. 66
      Installation.md

66
Installation.md

@ -17,7 +17,7 @@ chatto.datasource.params=useSSL=false
Then you would need to configure a reverse proxy, preferably with SSL. You can obtain a free SSL certificate from letsencrypt (be sure to donate if possible). Below is a sample nginx config -
```nginx
``` nginx
upstream chat {
server 127.0.0.1:8080;
}
@ -53,43 +53,55 @@ server {
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}
server {
if ($host = chat.example.com) {
return 301 https://$host$request_uri;
} # managed by Certbot
if ($host = www.chat.example.com) {
return 301 https://$host$request_uri;
} # managed by Certbot
listen 80 ;
listen [::]:80;
server_name chat.example.com;
return 404; # managed by Certbot
}
```
Place the file in ```bash /etc/nginx/sites-available/``` (depending on your linux distro this may differ).
Place the file in
```bash
/etc/nginx/sites-available/
```
(depending on your linux distro this may differ).
Now make a symlink -
```bash sudo ln -s /etc/nginx/sites-available/chatto /nginx/sites-enabled```
```bash
sudo ln -s /etc/nginx/sites-available/chatto /nginx/sites-enabled
```
verify configration -
```bash sudo nginx -t```
```bash
sudo nginx -t
```
and restart nginx -
```bash sudo systemctl restart nginx```
```bash
sudo systemctl restart nginx
```
Now create a linux user -
```bash sudo useradd -r -s /bin/false```
```bash
sudo useradd -r -s /bin/false
```
Next create a systemd script making use of the created user-
```
```
[Unit]
Description=System Daemon for Chatto
@ -104,12 +116,36 @@ RestartSec=10
[Install]
WantedBy=multi-user.target
```
Take note of the spring profiles argument. It enabled the production profile. Omitting it would run the app in dev profile.
Name the file chatto.service and place it in ```/etc/systemd/systemd```.
Name the file chatto.service and place it in
```
/etc/systemd/systemd
```
Reload systemd daemon -
```bash
sudo systemctl daemon-reload
```
Then start the service -
Reload systemd daemon - ```bash sudo systemctl daemon-reload```
Then start the service - ```bash sudo systemctl start chatto```
``` bash
sudo systemctl start chatto
```
If everything went well then the app should start.
Check with ```bash sudo systemctl status chatto``` and if it fails to start do ```sudo journalctl -u chatto``` to check the cause of the failure.
Check with
``` bash
sudo systemctl status chatto
```
and if it fails to start do
```
sudo journalctl -u chatto
```
to check the cause of the failure.
If everything went well then the app should start.
Loading…
Cancel
Save