public/conduit-faq.md

61 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

2024-05-22 11:03:59 +00:00
::: header
# conduit faq
this should be moved into the [actual website](https://conduit.rs) at some point
:::
::: section
## what features are supported?
- room versions 3-5 (unstable) and 6-10 (stable)
- spaces
- threads (although somewhat in a beta state)
- voice calls, with [coturn](https://github.com/coturn/coturn) set up
- appservices (meaning bridges will work)
## can i prune old media/events?
no
## why isn't conduit working?
a few common problems:
1. do you have a publicly reachable domain name? and a public + static ip address?
2. does that domain name have a valid tls certificate? (look at [certbot](https://certbot.eff.org/) or [caddy](https://caddyserver.com/) (reverse proxy))
3. is conduit running, and can you contact it from localhost?
4. what about from outside localhost?
5. is the response for `/` "hello from conduit!"?
6. have you previously had a different matrix homeserver (synapse, dendrite) running on the same domain? if so, wait a day or two for the other servers to forget the old key
## how do i make the first user account on conduit?
1. enable registration
2. register an account then quickly disable registration
(yeah, maybe not the best method at the moment)
## how do i configure conduit to ______?
in config.toml:
- disable federation: `enable_federation = false`
- disable appending a lightning bolt to my display name: `enable_lightning_bolt = false`
- use that coturn thing i set up: [check out this document](https://gitlab.com/famedly/conduit/-/blob/next/TURN.md?ref_type=heads)
## what is conduit using as its database, and how do i back up rocksdb?
[rocksdb](https://github.com/facebook/rocksdb/wiki). conduit technically
supports sqlite, but it's not recommended (conduit currently abuses
sqlite as a key/value rather than a relational database).
to back up the database, stop conduit, start conduit (to compact the db),
stop conduit again, backup the files in the data directory, then start
conduit. yes, unfortunately it is this janky. if you use zfs or btrfs,
snapshots may work, though i haven't tested it.
## how do i migrate from {synapse, dendrite}?
you can't
:::