76 lines
2.6 KiB
Markdown
76 lines
2.6 KiB
Markdown
# WorkAdventure XCE for Binary Kitchen
|
||
|
||
## Install Docker
|
||
|
||
### Set up the repository
|
||
1. Update the `apt` package index and install packages to allow `apt` to use a repository over HTTPS:
|
||
```
|
||
sudo apt-get update
|
||
sudo apt-get install \
|
||
ca-certificates \
|
||
curl \
|
||
gnupg \
|
||
lsb-release
|
||
```
|
||
|
||
2. Add Docker’s official GPG key:
|
||
`curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg`
|
||
|
||
3. Use the following command to set up the stable repository. To add the nightly or test repository, add the word `nightly` or `test` (or both) after the word `stable` in the commands below. Learn about nightly and test channels.
|
||
```
|
||
echo \
|
||
"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
|
||
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
||
```
|
||
|
||
### Install Docker Engine
|
||
This procedure works for Debian on `x86_64` / `amd64`, `armhf`, `arm64`, and Raspbian.
|
||
Update the `apt` package index, and install the latest version of Docker Engine and containerd, or go to the next step to install a specific version:
|
||
```
|
||
sudo apt-get update
|
||
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose
|
||
```
|
||
|
||
## Install other requirements
|
||
```
|
||
sudo apt-get install nginx git
|
||
```
|
||
|
||
## Create user and directories
|
||
```
|
||
sudo useradd -M workadventure
|
||
sudo adduser workadventure docker
|
||
sudo mkdir /opt/workadventure
|
||
sudo chown workadventure.workadventure /opt/workadventure
|
||
```
|
||
|
||
## Get workadventure source
|
||
Please make sure to edit the `.env` file to match your hostnames and Jitsi Servers before startup.
|
||
|
||
```
|
||
cd /opt/workadventure
|
||
sudo -u workadventure git clone --recurse-submodules https://git.binary-kitchen.de/noby/workadventure-xce.git source
|
||
```
|
||
|
||
## Install and start systemd service
|
||
```
|
||
sudo cp /opt/workadventure/source/dist/workadventure.service /etc/systemd/system
|
||
sudo systemctl daemon-reload
|
||
sudo systemctl enable workadventure
|
||
sudo systemctl start workadventure
|
||
```
|
||
|
||
## Install nginx vhost
|
||
```
|
||
sudo cp /opt/workadventure/source/dist/vhost /etc/nginx/sites-available/workadventure
|
||
sudo ln -s /etc/nginx/sites-available/workadventure /etc/nginx/sites-enabled/workadventure
|
||
```
|
||
|
||
Make sure to edit the `/etc/nginx/sites-enabled/workadventure` file and replace all occurances of
|
||
`{{ workadventure_domain }}` with your own domain. You also have to make sure that you specify the
|
||
correct paths to your certificates. You need a certificate for all the subdomains shown in the config.
|
||
|
||
If everything is done, restart nginx:
|
||
```
|
||
sudo systemctl restart nginx
|
||
``` |