mirror of
https://github.com/the-draupnir-project/Draupnir.git
synced 2026-03-31 19:35:39 +00:00
e4c02b96cd
* add .pre-commit-config.yaml Signed-off-by: Aminda Suomalainen <suomalainen+git@mikaela.info> * .editorconfig: decrease indent size for text * .pre-commit-config.yaml: remove prettier Signed-off-by: Aminda Suomalainen <suomalainen+git@mikaela.info> * .editorconfig consistency. * .pre-commit-config.yaml: restore sample hooks * .editorconfig: disable indent_size for LICENSE & NOTICE * pre-commit run --all-files * tsconfig.json: tabs to spaces * .pre-commit-config.yaml: update editorconfig-checker to 2.7.2 * .editorconfig: disable indent_size for markdown * mjolnir-entrypoint.sh: retab * .editorconfig: also exclude json from indent checking * test/nginx.conf: retab * test/integration/commands/redactCommandTest.ts: remove leading space * retab or remove leading whitespaces for the rest of the files * src/appservice/datastore.ts remove newlines * test/integration/commands/roomTest.ts: remove leading space. --------- Signed-off-by: Aminda Suomalainen <suomalainen+git@mikaela.info> Co-authored-by: gnuxie <Gnuxie@protonmail.com>
79 lines
3.2 KiB
Markdown
79 lines
3.2 KiB
Markdown
Draupnir is available on the Docker Hub as [`gnuxie/draupnir`](https://hub.docker.com/r/gnuxie/draupnir).
|
|
|
|
Using docker, draupnir can be setup and ran in either of two ways;
|
|
- Docker Run
|
|
- Docker Compose
|
|
|
|
Docker run will fire off a single-use container that is tied to your terminal's lifetime. (if you close the terminal, you shut down the bot)
|
|
|
|
Docker Compose can manage containers in the background, read a "compose" file, and automatically
|
|
recreate/restart relevant containers (upon `docker-compose up -d`) if they diverge from the file. It
|
|
can also easily read logs and manage the lifecycle of these containers. (start/stop/restart)
|
|
|
|
# Prerequisites
|
|
|
|
Before any other steps, a configuration file must be prepared.
|
|
|
|
Please go through [the sample configuration file's documentation](../config/default.yaml), download it, and rename it `production.yaml`.
|
|
|
|
You should go through and edit values to your liking, afterwards, pick a directory that'll be the root of all your draupnir data files (i.e. `./draupnir` from the home directory on your server), create a new directory called `config`, place the file there.
|
|
|
|
In short, please make sure that the draupnir configuration exists under `./config/production.yaml` relative to the directory you've chosen, else draupnir will not recognise it.
|
|
|
|
# Docker Run
|
|
|
|
Run the following command in your terminal, replace `./draupnir` with the root directory of your config, if it is in another spot.
|
|
|
|
```bash
|
|
docker run --rm -it -v ./draupnir:/data gnuxie/draupnir:latest bot --draupnir-config /data/config/production.yaml
|
|
```
|
|
|
|
# Docker Compose
|
|
|
|
Take the following file, and copy-paste it in `docker-compose.yml`;
|
|
|
|
```yaml
|
|
version: "3.3"
|
|
|
|
services:
|
|
draupnir:
|
|
image: gnuxie/draupnir:latest
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./draupnir:/data
|
|
```
|
|
|
|
If you have pantalaimon installed, you can include it in this compose file as follows;
|
|
|
|
```yaml
|
|
version: "3.3"
|
|
|
|
services:
|
|
pantalaimon:
|
|
build: ./pantalaimon
|
|
container_name: pantalaimon
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./pantalaimon_data:/data
|
|
ports:
|
|
- 8008:8008
|
|
draupnir:
|
|
image: gnuxie/draupnir:latest
|
|
restart: unless-stopped
|
|
volumes:
|
|
- ./draupnir:/data
|
|
```
|
|
|
|
**Note**: At the moment, pantalaimon does not have a Docker Hub image, so `./pantalaimon` needs to be the checked-out github repository, which you can do with `git clone https://github.com/matrix-org/pantalaimon`.
|
|
|
|
**Note**: In this configuration, you can access pantalaimon by using `pantalaimon` as a hostname, e.g. `http://pantalaimon:8080/` as `homeserverUrl`.
|
|
|
|
Replace `./draupnir` (and optionally `./pantalaimon_data`) with the correct directories.
|
|
|
|
Then call `docker-compose up -d` while in the same directory as `docker-compose.yml` to pull, create, and start the containers.
|
|
|
|
- Use `docker-compose stop` to stop all containers, or `docker-compose stop draupnir` to stop only the `draupnir` container.
|
|
- Use `docker-compose restart draupnir` to restart the draupnir container, omit to restart all containers.
|
|
- Use `docker-compose down` to stop and remove all containers.
|
|
- Use `docker-compose logs` to display container logs, append `-f` to follow the logs in your terminal, append `--tail 100` to only show the latest 100 entries.
|