dip/docs/deployment.md

44 lines
1.1 KiB
Markdown
Raw Normal View History

2018-09-18 02:29:50 +00:00
# Deployment
## Download Dip
The easiest way to get a copy of Dip is to download a binary from the [releases page](https://github.com/acmumn/dip/releases).
Alternatively, clone the repository and compile from source.
### HTTP Server setup
Dip runs an HTTP server. By default it serves on port 5000 on all interfaces. Use `--bind` on the executable to change this.
It's recommended to vhost your Dip through a server such as Nginx. Here's a sample Nginx config:
```
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header Host $host;
proxy_pass http://localhost:5000;
}
```
### Root configuration directory
Delegate a directory on your server to act as a root config directory.
### Systemd
Systemd is useful for keeping Dip running as a daemon, and starting it automatically on startup. Here's a sample systemd config:
```
[Unit]
Description=Configurable Webhook Server
[Service]
User=dip
Environment="RUST_BACKTRACE=1"
ExecStart=/usr/bin/dip --root /etc/dip --bind "127.0.0.1:5000"
[Install]
WantedBy=default.target
```