diff options
| author | Fuwn <[email protected]> | 2021-06-18 18:44:06 -0700 |
|---|---|---|
| committer | Fuwn <[email protected]> | 2021-06-18 18:44:06 -0700 |
| commit | 45fae7103bc98cf95a3b18aabce21fc644af6847 (patch) | |
| tree | ed459b3832bc72874650b22b933db3b6ab4dc6cf | |
| parent | style(index): move attributes around (diff) | |
| download | site-45fae7103bc98cf95a3b18aabce21fc644af6847.tar.xz site-45fae7103bc98cf95a3b18aabce21fc644af6847.zip | |
docs(deploying): create deploying information
| -rw-r--r-- | docs/whirl/deploying_setup.md | 97 | ||||
| -rw-r--r-- | sidebars.js | 1 | ||||
| -rw-r--r-- | src/pages/index.js | 8 |
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> ), |