Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/medienhaus/medienhaus-docker-dev

The medienhaus/ Docker composition for local development
https://github.com/medienhaus/medienhaus-docker-dev

docker-compose matrix-org

Last synced: about 1 month ago
JSON representation

The medienhaus/ Docker composition for local development

Awesome Lists containing this project

README

        

### medienhaus/

Customizable, modular, free and open-source environment for decentralized, distributed communication and collaboration without third-party dependencies.

[Website](https://medienhaus.dev/) — [Fediverse](https://chaos.social/@medienhaus)


# medienhaus-docker-dev

This repository contains our Docker composition for a containerized runtime environment of [medienhaus-spaces](https://github.com/medienhaus/medienhaus-spaces/) including [matrix-synapse](https://github.com/matrix-org/synapse/), [element-web](https://github.com/vector-im/element-web/), [etherpad-lite](https://github.com/ether/etherpad-lite/), [spacedeck-open](https://github.com/medienhaus/spacedeck-open/), and [lldap](https://github.com/lldap/lldap).


## Instructions

0. `git clone` the `medienhaus-docker-dev` repository and change directory


```
git clone https://github.com/medienhaus/medienhaus-docker-dev.git && \
cd medienhaus-docker-dev/
```

1. fetch contents of submodules


```
git submodule update --init
```

2. start docker composition and initialise `medienhaus-spaces`


```
docker compose up -d --wait && \
./scripts/init.sh
```

3. set up `lldap` user account(s) via: http://ldap.localhost/
- username: `admin`
- password: `change_me`

4. open the `medienhaus-spaces` application and log in via: http://localhost/login
- username: *(configured via `lldap`)*
- password: *(configured via `lldap`)*


## Development

Hot-reloading for `medienhaus-spaces` can be started via the following command.

```
docker compose watch
```

Cancelling the watcher via `CTRL-c` will **not** stop or shut down the composition.


## Destructions — reset everything and start from scratch

```
docker compose down && \
rm -rf data/etherpad && \
rm -rf data/matrix-synapse && \
rm -rf data/spacedeck && \
docker compose up -d --build --force-recreate --wait && \
./scripts/init.sh && \
docker compose up -d --build --force-recreate --wait medienhaus-spaces
```

💥 If you want to *TAKE ALL THE SHORTCUTS YOU CAN TAKE*, run `scripts/reset.sh`.

```
./scripts/reset.sh
```

🧩 For convenience reasons, manually created `lldap` accounts are not deleted.


## URLs / Links for default localhost setup

| Application / Service | URL / Link |
| --- | --- |
| `medienhaus-spaces` | http://localhost/ |
| `matrix-synapse` | http://matrix.localhost/ |
| `element-web` | http://element.localhost/ |
| `etherpad-lite` | http://etherpad.localhost/ |
| `spacedeck-open` | http://spacedeck.localhost/ |
| `lldap` | http://ldap.localhost/ |
| `traefik` | http://traefik.localhost/ |