aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFuwn <[email protected]>2021-06-18 18:44:06 -0700
committerFuwn <[email protected]>2021-06-18 18:44:06 -0700
commit45fae7103bc98cf95a3b18aabce21fc644af6847 (patch)
treeed459b3832bc72874650b22b933db3b6ab4dc6cf
parentstyle(index): move attributes around (diff)
downloadsite-45fae7103bc98cf95a3b18aabce21fc644af6847.tar.xz
site-45fae7103bc98cf95a3b18aabce21fc644af6847.zip
docs(deploying): create deploying information
-rw-r--r--docs/whirl/deploying_setup.md97
-rw-r--r--sidebars.js1
-rw-r--r--src/pages/index.js8
3 files changed, 103 insertions, 3 deletions
diff --git a/docs/whirl/deploying_setup.md b/docs/whirl/deploying_setup.md
new file mode 100644
index 0000000..5ad65bc
--- /dev/null
+++ b/docs/whirl/deploying_setup.md
@@ -0,0 +1,97 @@
+---
+title: Deploying (Setup)
+---
+
+So you want to deploy your own WhirlServer? Nice! You've come to the right
+place!
+
+## With Docker
+
+### Prerequisites
+
+- [Docker](https://docs.docker.com/engine/install/)
+
+### Usage
+
+```shell
+$ docker run \
+> -p 8080:80 \
+> -p 6650:6650 \
+> -p 5673:5673 \
+> -v /var/lib/whirl:/.whirl \
+> whirlsplash/whirl
+```
+
+#### Copyable
+
+```shell
+docker run -p 8080:80 -p 6650:6650 -p 5673:5673 -v /var/lib/whirl:/.whirl whirlsplash/whirl
+```
+
+### Notes
+
+Your configuration file can be found in `/var/lib/whirl/`.
+
+## With Docker Compose
+
+### Prerequisites
+
+- [Docker](https://docs.docker.com/compose/install/)
+- [Docker Compose](https://docs.docker.com/compose/install/) (newer versions of
+Docker include Docker Compose!)
+
+### Usage
+
+1. Create a directory, preferably in a monitorable location, `cd` into it, and
+ create a file named `docker-compose.yml` with the following contents:
+
+```yml
+# docker-compose.yml
+
+version: "3.3"
+services:
+ whirl:
+ ports:
+ - "8080:80" # API
+ - "6650:6650" # Distributor
+ - "5673:5673" # Hub
+ volumes:
+ - ./.whirl-data:/.whirl
+ image: whirlsplash/whirl
+```
+
+2. Execute `docker-compose up` (or `docker compose up` in later versions of
+ Docker).
+4. Wait around five seconds, if no errors are logged; `Ctrl + C` the process.
+ Whirl has now generated a default configuration file for you in the
+ `./whirl-data/` directory, `cd` into this directory and modify the
+ `Config.toml` to your liking.
+5. You may now `cd` back into the originally created directory and execute
+ `docker-compose up -d` (or `docker compose up -d` in later versions of
+ Docker).
+
+### Notes
+
+Your configuration file can be found in `./whirl-data/`.
+
+## With a Standalone Binary (Currently only for developmental use)
+
+1. Create a directory, preferably in a monitorable location and `cd` into it.
+2. Download the latest binary release of your platform (if available) from the
+ Whirl [releases page](https://github.com/Whirlsplash/whirl/releases/latest).
+3. Execute `whirl run distributor`
+4. Wait around five seconds, if no errors are logged: `Ctrl + C` the process.
+ Whirl has now generated a default configuration file for you in the
+ `./whirl/` directory, `cd` into this directory and modify the
+ `Config.toml` to your liking.
+5. You may now `cd` back into the originally created directory and execute
+ `whirl run` (or `whirl run distributor,hub` if you would like to run only a
+ select few of Whirl's sub-servers).
+
+### Notes
+
+Your configuration file can be found in `./whirl/`.
+
+## Notes
+
+systemd configuration may (?) come soon!
diff --git a/sidebars.js b/sidebars.js
index e3718bd..2ac8bac 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -24,6 +24,7 @@ module.exports = {
type: 'category',
label: 'Whirl',
items: [
+ 'whirl/deploying_setup',
'whirl/configuration',
],
},
diff --git a/src/pages/index.js b/src/pages/index.js
index fdee44c..b43db7c 100644
--- a/src/pages/index.js
+++ b/src/pages/index.js
@@ -25,9 +25,11 @@ const features = [
standalone binaries</a> are offered!
</div>
<div className="card__footer">
- <button className="button button--primary button--block disabled">
- Get Started
- </button>
+ <a href="/docs/whirl/deploying_setup" target="_blank">
+ <button className="button button--primary button--block">
+ Get Started
+ </button>
+ </a>
</div>
</div>
),