chore(docs): update docs

This commit is contained in:
Johan Siebens
2024-04-26 11:22:06 +02:00
parent 128a184a59
commit 0b5f54c7d3
2 changed files with 14 additions and 15 deletions
+8 -8
View File
@@ -4,7 +4,7 @@ You can install and run __ionscale__ using the Docker images published on [GitHu
## Requirements ## Requirements
- A Linux machine with port 80 and 443 open to ingress traffic. - A Linux machine with port 443 and 3478 open to ingress traffic.
- Docker installed. See the [official installation documentation](https://docs.docker.com/install/) - Docker installed. See the [official installation documentation](https://docs.docker.com/install/)
- A registered domain name. - A registered domain name.
@@ -33,15 +33,15 @@ Generate a configuration file for __ionscale__ with the following commands:
``` bash ``` bash
export IONSCALE_ACME_EMAIL=<your email> export IONSCALE_ACME_EMAIL=<your email>
export IONSCALE_ADDR=https://ionscale.example.com export IONSCALE_DOMAIN=ionscale.example.com
export IONSCALE_SYSTEM_ADMIN_KEY=$(docker run ghcr.io/jsiebens/ionscale:0.13.0 genkey -n) export IONSCALE_SYSTEM_ADMIN_KEY=$(docker run ghcr.io/jsiebens/ionscale:0.15.0 genkey -n)
``` ```
``` bash ``` bash
tee ./config.yaml >/dev/null <<EOF tee ./config.yaml >/dev/null <<EOF
http_listen_addr: ":80" listen_addr: ":443"
https_listen_addr: ":443" public_addr: "${IONSCALE_DOMAIN}:443"
server_url: "${IONSCALE_ADDR}" stun_public_addr: "${IONSCALE_DOMAIN}:3478"
tls: tls:
acme: true acme: true
@@ -66,7 +66,7 @@ Run an __ionscale__ instance with the following command:
docker run \ docker run \
-v $(pwd)/config.yaml:/etc/ionscale/config.yaml \ -v $(pwd)/config.yaml:/etc/ionscale/config.yaml \
-v $(pwd)/data:/data \ -v $(pwd)/data:/data \
-p 80:80 \
-p 443:443 \ -p 443:443 \
ghcr.io/jsiebens/ionscale:0.13.0 server --config /etc/ionscale/config.yaml -p 3478:3478/udp \
ghcr.io/jsiebens/ionscale:0.15.0 server --config /etc/ionscale/config.yaml
``` ```
+6 -7
View File
@@ -4,7 +4,7 @@ This tutorial will guide you through the steps needed to install and run __ionsc
## Prerequisites ## Prerequisites
- A Linux machine with port 80 and 443 open to ingress traffic. - A Linux machine with port 443 and 3478 open to ingress traffic.
- A registered domain name. - A registered domain name.
## Step 1. Configure DNS ## Step 1. Configure DNS
@@ -41,7 +41,7 @@ Run the following commands to install the __ionscale__ binary on your Linux host
``` bash ``` bash
sudo curl \ sudo curl \
-o "/usr/local/bin/ionscale" \ -o "/usr/local/bin/ionscale" \
-sfL "https://github.com/jsiebens/ionscale/releases/download/v0.13.0/ionscale_linux_amd64" -sfL "https://github.com/jsiebens/ionscale/releases/download/v0.15.0/ionscale_linux_amd64"
sudo chmod +x "/usr/local/bin/ionscale" sudo chmod +x "/usr/local/bin/ionscale"
``` ```
@@ -60,19 +60,18 @@ Generate a configuration file for __ionscale__ with the following commands:
``` bash ``` bash
export IONSCALE_ACME_EMAIL=<your email> export IONSCALE_ACME_EMAIL=<your email>
export IONSCALE_ADDR=https://ionscale.example.com export IONSCALE_DOMAIN=ionscale.example.com
``` ```
``` bash ``` bash
sudo tee /etc/ionscale/config.yaml >/dev/null <<EOF sudo tee /etc/ionscale/config.yaml >/dev/null <<EOF
http_listen_addr: ":80" listen_addr: ":443"
https_listen_addr: ":443" public_addr: "${IONSCALE_DOMAIN}:443"
server_url: "https://${IONSCALE_DOMAIN}" stun_public_addr: "${IONSCALE_DOMAIN}:3478"
tls: tls:
acme: true acme: true
acme_email: "${IONSCALE_ACME_EMAIL}" acme_email: "${IONSCALE_ACME_EMAIL}"
acme_path: "/var/lib/ionscale/acme"
database: database:
url: "/var/lib/ionscale/ionscale.db?_pragma=busy_timeout(5000)&_pragma=journal_mode(WAL)" url: "/var/lib/ionscale/ionscale.db?_pragma=busy_timeout(5000)&_pragma=journal_mode(WAL)"