2021-10-12 11:37:20 +00:00
|
|
|
# snikket
|
2021-10-12 11:35:23 +00:00
|
|
|
|
2022-01-19 14:24:34 +00:00
|
|
|
> It's very experimental and we're forking a number of configs right now, see
|
|
|
|
> the [issues list](https://git.coopcloud.tech/coop-cloud/snikket/issues) for
|
|
|
|
> more.
|
|
|
|
|
2021-10-12 11:37:20 +00:00
|
|
|
Chat that is simple, secure, and private.
|
2021-10-12 11:35:23 +00:00
|
|
|
|
|
|
|
<!-- metadata -->
|
|
|
|
|
2021-12-26 01:31:57 +00:00
|
|
|
* **Category**: Apps
|
|
|
|
* **Status**:
|
|
|
|
* **Image**: [`thecoopcloud/snikket-*`](https://hub.docker.com/u/thecoopcloud)
|
|
|
|
* **Healthcheck**:
|
|
|
|
* **Backups**:
|
|
|
|
* **Email**:
|
|
|
|
* **Tests**:
|
|
|
|
* **SSO**:
|
2021-10-12 11:35:23 +00:00
|
|
|
|
|
|
|
<!-- endmetadata -->
|
2021-12-04 23:35:16 +00:00
|
|
|
|
2022-01-09 14:05:14 +00:00
|
|
|
## Tricks & Tips
|
|
|
|
|
|
|
|
### Post-deploy steps
|
|
|
|
|
|
|
|
The `certs` service needs to copy over the right certificates from traefik. If
|
2022-01-09 14:10:11 +00:00
|
|
|
you're deploying for the first time, then this could take a minute. Once the
|
|
|
|
certs are copied over, you'll have to manually restart the `app` service and
|
|
|
|
potentially the `server` service.
|
2022-01-09 14:05:14 +00:00
|
|
|
|
|
|
|
```
|
2022-01-09 14:10:11 +00:00
|
|
|
abra app logs <yoursnikket> certs
|
2022-01-09 14:05:14 +00:00
|
|
|
abra app run <yoursnikket> server ls -lha /certs
|
2022-01-09 14:15:28 +00:00
|
|
|
abra app restart <yoursnikket> server # check logs to see it picks up certs
|
|
|
|
abra app restart <yoursnikket> app # your ${DOMAIN} web log in should work now
|
2022-01-09 14:05:14 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### DNS requirements
|
|
|
|
|
|
|
|
You need 3 A records, pointing to the same IP.
|
|
|
|
|
|
|
|
- **chat.foo.com**: main web log in
|
|
|
|
- **share.chat.foo.com**: file upload
|
|
|
|
- **groups.chat.foo.com**: muc support
|
|
|
|
|
|
|
|
### Create admin invite
|
2021-12-04 23:35:16 +00:00
|
|
|
|
2022-01-01 14:28:30 +00:00
|
|
|
```
|
|
|
|
abra app run <app> server create-invite --admin --group default
|
|
|
|
```
|
|
|
|
|
2022-01-09 14:16:27 +00:00
|
|
|
### How does the `coturn` setup work?
|
2022-01-01 14:28:30 +00:00
|
|
|
|
2022-01-09 14:16:27 +00:00
|
|
|
We default to using an external `coturn` to support the homebrew server as a
|
2022-01-09 14:14:35 +00:00
|
|
|
first class citizen. `coturn` is known to not work at all if behind a NAT and
|
2022-01-09 14:05:14 +00:00
|
|
|
is better served directlry from a ipv4. For homebrew setups (behind router),
|
2022-01-09 14:16:27 +00:00
|
|
|
it's better to dial out to an external `coturn` server. Hence, you'll need to
|
2022-01-09 14:14:35 +00:00
|
|
|
bring your own `coturn` server configuration to use this recipe.
|
2022-01-09 14:05:14 +00:00
|
|
|
|
2022-01-09 14:16:27 +00:00
|
|
|
If you want to use the internal Snikket `coturn` setup, use the following:
|
2022-01-01 14:28:30 +00:00
|
|
|
|
|
|
|
```
|
2022-01-09 14:05:14 +00:00
|
|
|
COMPOSE_FILE="compose.yml:compose.coturn-int.yml"
|
2022-01-01 14:28:30 +00:00
|
|
|
```
|
2022-01-09 14:05:14 +00:00
|
|
|
|
|
|
|
There are issues with exposing the required amount of ports, please see
|
|
|
|
[`#5`](https://git.coopcloud.tech/coop-cloud/snikket/issues/5).
|
2022-01-19 14:24:34 +00:00
|
|
|
|