mirror of
https://gitlab.com/famedly/conduit.git
synced 2024-11-14 12:41:05 +01:00
easier-to-read docker setup instructions
This commit is contained in:
parent
3a1a72df98
commit
06a1321e56
1 changed files with 29 additions and 12 deletions
|
@ -4,7 +4,31 @@
|
||||||
|
|
||||||
## Docker
|
## Docker
|
||||||
|
|
||||||
### Build & Dockerfile
|
To run conduit with docker you can either build the image yourself or pull it from a registry.
|
||||||
|
|
||||||
|
|
||||||
|
### Use a registry
|
||||||
|
|
||||||
|
The image is available in the following registries:
|
||||||
|
|
||||||
|
| Registry | Image | Size |
|
||||||
|
| --------------- | --------------------------------------------------------------- | --------------------- |
|
||||||
|
| Docker Hub | [matrixconduit/matrix-conduit:latest][dh] | ![Image Size][shield] |
|
||||||
|
| GitLab Registry | [registry.gitlab.com/famedly/conduit/matrix-conduit:latest][gl] | ![Image Size][shield] |
|
||||||
|
|
||||||
|
[dh]: https://hub.docker.com/r/matrixconduit/matrix-conduit
|
||||||
|
[gl]: https://gitlab.com/famedly/conduit/container_registry/2497937
|
||||||
|
[shield]: https://img.shields.io/docker/image-size/matrixconduit/matrix-conduit/latest
|
||||||
|
|
||||||
|
Use
|
||||||
|
```bash
|
||||||
|
docker image pull <link>
|
||||||
|
```
|
||||||
|
to pull it to your machine.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### Build using a dockerfile
|
||||||
|
|
||||||
The Dockerfile provided by Conduit has two stages, each of which creates an image.
|
The Dockerfile provided by Conduit has two stages, each of which creates an image.
|
||||||
|
|
||||||
|
@ -19,9 +43,11 @@ docker build --tag matrixconduit/matrix-conduit:latest .
|
||||||
|
|
||||||
which also will tag the resulting image as `matrixconduit/matrix-conduit:latest`.
|
which also will tag the resulting image as `matrixconduit/matrix-conduit:latest`.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### Run
|
### Run
|
||||||
|
|
||||||
After building the image you can simply run it with
|
When you have the image you can simply run it with
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -d -p 8448:6167 \
|
docker run -d -p 8448:6167 \
|
||||||
|
@ -37,16 +63,7 @@ docker run -d -p 8448:6167 \
|
||||||
--name conduit matrixconduit/matrix-conduit:latest
|
--name conduit matrixconduit/matrix-conduit:latest
|
||||||
```
|
```
|
||||||
|
|
||||||
or you can skip the build step and pull the image from one of the following registries:
|
or you can use [docker-compose](#docker-compose).
|
||||||
|
|
||||||
| Registry | Image | Size |
|
|
||||||
| --------------- | --------------------------------------------------------------- | --------------------- |
|
|
||||||
| Docker Hub | [matrixconduit/matrix-conduit:latest][dh] | ![Image Size][shield] |
|
|
||||||
| GitLab Registry | [registry.gitlab.com/famedly/conduit/matrix-conduit:latest][gl] | ![Image Size][shield] |
|
|
||||||
|
|
||||||
[dh]: https://hub.docker.com/r/matrixconduit/matrix-conduit
|
|
||||||
[gl]: https://gitlab.com/famedly/conduit/container_registry/2497937
|
|
||||||
[shield]: https://img.shields.io/docker/image-size/matrixconduit/matrix-conduit/latest
|
|
||||||
|
|
||||||
The `-d` flag lets the container run in detached mode. You now need to supply a `conduit.toml` config file, an example can be found [here](../conduit-example.toml).
|
The `-d` flag lets the container run in detached mode. You now need to supply a `conduit.toml` config file, an example can be found [here](../conduit-example.toml).
|
||||||
You can pass in different env vars to change config values on the fly. You can even configure Conduit completely by using env vars, but for that you need
|
You can pass in different env vars to change config values on the fly. You can even configure Conduit completely by using env vars, but for that you need
|
||||||
|
|
Loading…
Reference in a new issue