docs: Rename in more places
This commit is contained in:
parent
3eb4ee7af1
commit
f791dc6918
8 changed files with 32 additions and 32 deletions
|
@ -1,4 +1,4 @@
|
||||||
# conduwuit - Behind Traefik Reverse Proxy
|
# Continuwuity - Behind Traefik Reverse Proxy
|
||||||
|
|
||||||
services:
|
services:
|
||||||
homeserver:
|
homeserver:
|
||||||
|
@ -36,14 +36,14 @@ services:
|
||||||
server=your.server.name.example:443
|
server=your.server.name.example:443
|
||||||
}
|
}
|
||||||
#cpuset: "0-4" # Uncomment to limit to specific CPU cores
|
#cpuset: "0-4" # Uncomment to limit to specific CPU cores
|
||||||
ulimits: # conduwuit uses quite a few file descriptors, and on some systems it defaults to 1024, so you can tell docker to increase it
|
ulimits: # Continuwuity uses quite a few file descriptors, and on some systems it defaults to 1024, so you can tell docker to increase it
|
||||||
nofile:
|
nofile:
|
||||||
soft: 1048567
|
soft: 1048567
|
||||||
hard: 1048567
|
hard: 1048567
|
||||||
|
|
||||||
### Uncomment if you want to use your own Element-Web App.
|
### Uncomment if you want to use your own Element-Web App.
|
||||||
### Note: You need to provide a config.json for Element and you also need a second
|
### Note: You need to provide a config.json for Element and you also need a second
|
||||||
### Domain or Subdomain for the communication between Element and conduwuit
|
### Domain or Subdomain for the communication between Element and Continuwuity
|
||||||
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
||||||
# element-web:
|
# element-web:
|
||||||
# image: vectorim/element-web:latest
|
# image: vectorim/element-web:latest
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
# conduwuit - Traefik Reverse Proxy Labels
|
# Continuwuity - Traefik Reverse Proxy Labels
|
||||||
|
|
||||||
services:
|
services:
|
||||||
homeserver:
|
homeserver:
|
||||||
|
@ -6,7 +6,7 @@ services:
|
||||||
- "traefik.enable=true"
|
- "traefik.enable=true"
|
||||||
- "traefik.docker.network=proxy" # Change this to the name of your Traefik docker proxy network
|
- "traefik.docker.network=proxy" # Change this to the name of your Traefik docker proxy network
|
||||||
|
|
||||||
- "traefik.http.routers.to-conduwuit.rule=Host(`<SUBDOMAIN>.<DOMAIN>`)" # Change to the address on which conduwuit is hosted
|
- "traefik.http.routers.to-conduwuit.rule=Host(`<SUBDOMAIN>.<DOMAIN>`)" # Change to the address on which Continuwuity is hosted
|
||||||
- "traefik.http.routers.to-conduwuit.tls=true"
|
- "traefik.http.routers.to-conduwuit.tls=true"
|
||||||
- "traefik.http.routers.to-conduwuit.tls.certresolver=letsencrypt"
|
- "traefik.http.routers.to-conduwuit.tls.certresolver=letsencrypt"
|
||||||
- "traefik.http.routers.to-conduwuit.middlewares=cors-headers@docker"
|
- "traefik.http.routers.to-conduwuit.middlewares=cors-headers@docker"
|
||||||
|
@ -16,7 +16,7 @@ services:
|
||||||
- "traefik.http.middlewares.cors-headers.headers.accessControlAllowHeaders=Origin, X-Requested-With, Content-Type, Accept, Authorization"
|
- "traefik.http.middlewares.cors-headers.headers.accessControlAllowHeaders=Origin, X-Requested-With, Content-Type, Accept, Authorization"
|
||||||
- "traefik.http.middlewares.cors-headers.headers.accessControlAllowMethods=GET, POST, PUT, DELETE, OPTIONS"
|
- "traefik.http.middlewares.cors-headers.headers.accessControlAllowMethods=GET, POST, PUT, DELETE, OPTIONS"
|
||||||
|
|
||||||
# If you want to have your account on <DOMAIN>, but host conduwuit on a subdomain,
|
# If you want to have your account on <DOMAIN>, but host Continuwuity on a subdomain,
|
||||||
# you can let it only handle the well known file on that domain instead
|
# you can let it only handle the well known file on that domain instead
|
||||||
#- "traefik.http.routers.to-matrix-wellknown.rule=Host(`<DOMAIN>`) && PathPrefix(`/.well-known/matrix`)"
|
#- "traefik.http.routers.to-matrix-wellknown.rule=Host(`<DOMAIN>`) && PathPrefix(`/.well-known/matrix`)"
|
||||||
#- "traefik.http.routers.to-matrix-wellknown.tls=true"
|
#- "traefik.http.routers.to-matrix-wellknown.tls=true"
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
services:
|
services:
|
||||||
caddy:
|
caddy:
|
||||||
# This compose file uses caddy-docker-proxy as the reverse proxy for conduwuit!
|
# This compose file uses caddy-docker-proxy as the reverse proxy for Continuwuity!
|
||||||
# For more info, visit https://github.com/lucaslorentz/caddy-docker-proxy
|
# For more info, visit https://github.com/lucaslorentz/caddy-docker-proxy
|
||||||
image: lucaslorentz/caddy-docker-proxy:ci-alpine
|
image: lucaslorentz/caddy-docker-proxy:ci-alpine
|
||||||
ports:
|
ports:
|
||||||
|
@ -20,7 +20,7 @@ services:
|
||||||
caddy.1_respond: /.well-known/matrix/client {"m.server":{"base_url":"https://matrix.example.com"},"m.homeserver":{"base_url":"https://matrix.example.com"},"org.matrix.msc3575.proxy":{"url":"https://matrix.example.com"}}
|
caddy.1_respond: /.well-known/matrix/client {"m.server":{"base_url":"https://matrix.example.com"},"m.homeserver":{"base_url":"https://matrix.example.com"},"org.matrix.msc3575.proxy":{"url":"https://matrix.example.com"}}
|
||||||
|
|
||||||
homeserver:
|
homeserver:
|
||||||
### If you already built the conduwuit image with 'docker build' or want to use a registry image,
|
### If you already built the Continuwuity image with 'docker build' or want to use a registry image,
|
||||||
### then you are ready to go.
|
### then you are ready to go.
|
||||||
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
# conduwuit - Behind Traefik Reverse Proxy
|
# Continuwuity - Behind Traefik Reverse Proxy
|
||||||
|
|
||||||
services:
|
services:
|
||||||
homeserver:
|
homeserver:
|
||||||
### If you already built the conduwuit image with 'docker build' or want to use the Docker Hub image,
|
### If you already built the Continuwuity image with 'docker build' or want to use the Docker Hub image,
|
||||||
### then you are ready to go.
|
### then you are ready to go.
|
||||||
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
@ -22,7 +22,7 @@ services:
|
||||||
CONDUWUIT_PORT: 6167 # you need to match this with the traefik load balancer label if you're want to change it
|
CONDUWUIT_PORT: 6167 # you need to match this with the traefik load balancer label if you're want to change it
|
||||||
CONDUWUIT_DATABASE_PATH: /var/lib/conduwuit
|
CONDUWUIT_DATABASE_PATH: /var/lib/conduwuit
|
||||||
#CONDUWUIT_CONFIG: '/etc/conduit.toml' # Uncomment if you mapped config toml above
|
#CONDUWUIT_CONFIG: '/etc/conduit.toml' # Uncomment if you mapped config toml above
|
||||||
### Uncomment and change values as desired, note that conduwuit has plenty of config options, so you should check out the example example config too
|
### Uncomment and change values as desired, note that Continuwuity has plenty of config options, so you should check out the example example config too
|
||||||
# Available levels are: error, warn, info, debug, trace - more info at: https://docs.rs/env_logger/*/env_logger/#enabling-logging
|
# Available levels are: error, warn, info, debug, trace - more info at: https://docs.rs/env_logger/*/env_logger/#enabling-logging
|
||||||
# CONDUWUIT_LOG: info # default is: "warn,state_res=warn"
|
# CONDUWUIT_LOG: info # default is: "warn,state_res=warn"
|
||||||
# CONDUWUIT_ALLOW_ENCRYPTION: 'true'
|
# CONDUWUIT_ALLOW_ENCRYPTION: 'true'
|
||||||
|
@ -44,14 +44,14 @@ services:
|
||||||
server=your.server.name.example:443
|
server=your.server.name.example:443
|
||||||
}
|
}
|
||||||
#cpuset: "0-4" # Uncomment to limit to specific CPU cores
|
#cpuset: "0-4" # Uncomment to limit to specific CPU cores
|
||||||
ulimits: # conduwuit uses quite a few file descriptors, and on some systems it defaults to 1024, so you can tell docker to increase it
|
ulimits: # Continuwuity uses quite a few file descriptors, and on some systems it defaults to 1024, so you can tell docker to increase it
|
||||||
nofile:
|
nofile:
|
||||||
soft: 1048567
|
soft: 1048567
|
||||||
hard: 1048567
|
hard: 1048567
|
||||||
|
|
||||||
### Uncomment if you want to use your own Element-Web App.
|
### Uncomment if you want to use your own Element-Web App.
|
||||||
### Note: You need to provide a config.json for Element and you also need a second
|
### Note: You need to provide a config.json for Element and you also need a second
|
||||||
### Domain or Subdomain for the communication between Element and conduwuit
|
### Domain or Subdomain for the communication between Element and Continuwuity
|
||||||
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
||||||
# element-web:
|
# element-web:
|
||||||
# image: vectorim/element-web:latest
|
# image: vectorim/element-web:latest
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
# conduwuit
|
# Continuwuity
|
||||||
|
|
||||||
services:
|
services:
|
||||||
homeserver:
|
homeserver:
|
||||||
### If you already built the conduwuit image with 'docker build' or want to use a registry image,
|
### If you already built the Continuwuity image with 'docker build' or want to use a registry image,
|
||||||
### then you are ready to go.
|
### then you are ready to go.
|
||||||
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
image: forgejo.ellis.link/continuwuation/continuwuity:latest
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
@ -28,7 +28,7 @@ services:
|
||||||
#
|
#
|
||||||
### Uncomment if you want to use your own Element-Web App.
|
### Uncomment if you want to use your own Element-Web App.
|
||||||
### Note: You need to provide a config.json for Element and you also need a second
|
### Note: You need to provide a config.json for Element and you also need a second
|
||||||
### Domain or Subdomain for the communication between Element and conduwuit
|
### Domain or Subdomain for the communication between Element and Continuwuity
|
||||||
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
### Config-Docs: https://github.com/vector-im/element-web/blob/develop/docs/config.md
|
||||||
# element-web:
|
# element-web:
|
||||||
# image: vectorim/element-web:latest
|
# image: vectorim/element-web:latest
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
# conduwuit for Kubernetes
|
# Continuwuity for Kubernetes
|
||||||
|
|
||||||
conduwuit doesn't support horizontal scalability or distributed loading
|
Continuwuity doesn't support horizontal scalability or distributed loading
|
||||||
natively, however a community maintained Helm Chart is available here to run
|
natively, however a community maintained Helm Chart is available here to run
|
||||||
conduwuit on Kubernetes: <https://gitlab.cronce.io/charts/conduwuit>
|
Continuwuity on Kubernetes: <https://gitlab.cronce.io/charts/conduwuit>
|
||||||
|
|
||||||
Should changes need to be made, please reach out to the maintainer in our
|
Should changes need to be made, please reach out to the maintainer in our
|
||||||
Matrix room as this is not maintained/controlled by the conduwuit maintainers.
|
Matrix room as this is not maintained/controlled by the Continuwuity maintainers.
|
||||||
|
|
|
@ -5,7 +5,7 @@ guaranteed to work at this time.
|
||||||
|
|
||||||
### Summary
|
### Summary
|
||||||
|
|
||||||
When developing in debug-builds with the nightly toolchain, conduwuit is modular
|
When developing in debug-builds with the nightly toolchain, Continuwuity is modular
|
||||||
using dynamic libraries and various parts of the application are hot-reloadable
|
using dynamic libraries and various parts of the application are hot-reloadable
|
||||||
while the server is running: http api handlers, admin commands, services,
|
while the server is running: http api handlers, admin commands, services,
|
||||||
database, etc. These are all split up into individual workspace crates as seen
|
database, etc. These are all split up into individual workspace crates as seen
|
||||||
|
@ -42,7 +42,7 @@ library, macOS, and likely other host architectures are not supported (if other
|
||||||
architectures work, feel free to let us know and/or make a PR updating this).
|
architectures work, feel free to let us know and/or make a PR updating this).
|
||||||
This should work on GNU ld and lld (rust-lld) and gcc/clang, however if you
|
This should work on GNU ld and lld (rust-lld) and gcc/clang, however if you
|
||||||
happen to have linker issues it's recommended to try using `mold` or `gold`
|
happen to have linker issues it's recommended to try using `mold` or `gold`
|
||||||
linkers, and please let us know in the [conduwuit Matrix room][7] the linker
|
linkers, and please let us know in the [Continuwuity Matrix room][7] the linker
|
||||||
error and what linker solved this issue so we can figure out a solution. Ideally
|
error and what linker solved this issue so we can figure out a solution. Ideally
|
||||||
there should be minimal friction to using this, and in the future a build script
|
there should be minimal friction to using this, and in the future a build script
|
||||||
(`build.rs`) may be suitable to making this easier to use if the capabilities
|
(`build.rs`) may be suitable to making this easier to use if the capabilities
|
||||||
|
@ -52,13 +52,13 @@ allow us.
|
||||||
|
|
||||||
As of 19 May 2024, the instructions for using this are:
|
As of 19 May 2024, the instructions for using this are:
|
||||||
|
|
||||||
0. Have patience. Don't hesitate to join the [conduwuit Matrix room][7] to
|
0. Have patience. Don't hesitate to join the [Continuwuity Matrix room][7] to
|
||||||
receive help using this. As indicated by the various rustflags used and some
|
receive help using this. As indicated by the various rustflags used and some
|
||||||
of the interesting issues linked at the bottom, this is definitely not something
|
of the interesting issues linked at the bottom, this is definitely not something
|
||||||
the Rust ecosystem or toolchain is used to doing.
|
the Rust ecosystem or toolchain is used to doing.
|
||||||
|
|
||||||
1. Install the nightly toolchain using rustup. You may need to use `rustup
|
1. Install the nightly toolchain using rustup. You may need to use `rustup
|
||||||
override set nightly` in your local conduwuit directory, or use `cargo
|
override set nightly` in your local Continuwuity directory, or use `cargo
|
||||||
+nightly` for all actions.
|
+nightly` for all actions.
|
||||||
|
|
||||||
2. Uncomment `cargo-features` at the top level / root Cargo.toml
|
2. Uncomment `cargo-features` at the top level / root Cargo.toml
|
||||||
|
@ -85,14 +85,14 @@ LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/.rustup/toolchains/nightly-x86_64-unknown
|
||||||
Cargo should only rebuild what was changed / what's necessary, so it should
|
Cargo should only rebuild what was changed / what's necessary, so it should
|
||||||
not be rebuilding all the crates.
|
not be rebuilding all the crates.
|
||||||
|
|
||||||
9. In your conduwuit server terminal, hit/send `CTRL+C` signal. This will tell
|
9. In your Continuwuity server terminal, hit/send `CTRL+C` signal. This will tell
|
||||||
conduwuit to find which libraries need to be reloaded, and reloads them as
|
Continuwuity to find which libraries need to be reloaded, and reloads them as
|
||||||
necessary.
|
necessary.
|
||||||
|
|
||||||
10. If there were no errors, it will tell you it successfully reloaded `#`
|
10. If there were no errors, it will tell you it successfully reloaded `#`
|
||||||
modules, and your changes should now be visible. Repeat 7 - 9 as needed.
|
modules, and your changes should now be visible. Repeat 7 - 9 as needed.
|
||||||
|
|
||||||
To shutdown conduwuit in this setup, hit/send `CTRL+\`. Normal builds still
|
To shutdown Continuwuity in this setup, hit/send `CTRL+\`. Normal builds still
|
||||||
shutdown with `CTRL+C` as usual.
|
shutdown with `CTRL+C` as usual.
|
||||||
|
|
||||||
Steps 1 - 5 are the initial first-time steps for using this. To remove the hot
|
Steps 1 - 5 are the initial first-time steps for using this. To remove the hot
|
||||||
|
@ -101,7 +101,7 @@ reload setup, revert/comment all the Cargo.toml changes.
|
||||||
As mentioned in the requirements section, if you happen to have some linker
|
As mentioned in the requirements section, if you happen to have some linker
|
||||||
issues, try using the `-fuse-ld=` rustflag and specify mold or gold in all the
|
issues, try using the `-fuse-ld=` rustflag and specify mold or gold in all the
|
||||||
`rustflags` definitions in the top level Cargo.toml, and please let us know in
|
`rustflags` definitions in the top level Cargo.toml, and please let us know in
|
||||||
the [conduwuit Matrix room][7] the problem. mold can be installed typically
|
the [Continuwuity Matrix room][7] the problem. mold can be installed typically
|
||||||
through your distro, and gold is provided by the binutils package.
|
through your distro, and gold is provided by the binutils package.
|
||||||
|
|
||||||
It's possible a helper script can be made to do all of this, or most preferably
|
It's possible a helper script can be made to do all of this, or most preferably
|
||||||
|
@ -136,7 +136,7 @@ acyclic graph. The primary rule is simple and illustrated in the figure below:
|
||||||
**no crate is allowed to call a function or use a variable from a crate below
|
**no crate is allowed to call a function or use a variable from a crate below
|
||||||
it.**
|
it.**
|
||||||
|
|
||||||

|
Volk](assets/libraries.png)
|
||||||
|
|
||||||
When a symbol is referenced between crates they become bound: **crates cannot be
|
When a symbol is referenced between crates they become bound: **crates cannot be
|
||||||
|
@ -147,7 +147,7 @@ by using an `RTLD_LOCAL` binding for just one link between the main executable
|
||||||
and the first crate, freeing the executable from all modules as no global
|
and the first crate, freeing the executable from all modules as no global
|
||||||
binding ever occurs between them.
|
binding ever occurs between them.
|
||||||
|
|
||||||

|
Volk](assets/reload_order.png)
|
||||||
|
|
||||||
Proper resource management is essential for reliable reloading to occur. This is
|
Proper resource management is essential for reliable reloading to occur. This is
|
||||||
|
@ -196,5 +196,5 @@ The initial implementation PR is available [here][1].
|
||||||
[4]: https://github.com/rust-lang/rust/issues/28794#issuecomment-368693049
|
[4]: https://github.com/rust-lang/rust/issues/28794#issuecomment-368693049
|
||||||
[5]: https://github.com/rust-lang/cargo/issues/12746
|
[5]: https://github.com/rust-lang/cargo/issues/12746
|
||||||
[6]: https://crates.io/crates/hot-lib-reloader/
|
[6]: https://crates.io/crates/hot-lib-reloader/
|
||||||
[7]: https://matrix.to/#/#conduwuit:puppygock.gay
|
[7]: https://matrix.to/#/#continuwuity:continuwuity.org
|
||||||
[8]: https://crates.io/crates/libloading
|
[8]: https://crates.io/crates/libloading
|
||||||
|
|
|
@ -36,7 +36,7 @@ pub(super) enum ServerCommand {
|
||||||
/// - Print database memory usage statistics
|
/// - Print database memory usage statistics
|
||||||
MemoryUsage,
|
MemoryUsage,
|
||||||
|
|
||||||
/// - Clears all of Conduwuit's caches
|
/// - Clears all of Continuwuity's caches
|
||||||
ClearCaches,
|
ClearCaches,
|
||||||
|
|
||||||
/// - Performs an online backup of the database (only available for RocksDB
|
/// - Performs an online backup of the database (only available for RocksDB
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue