docs: Add basic configuration instructions for RPM page #2275

Merged
Aranjedeath merged 5 commits from stratself/continuwuity:stratself/docs-rpm-fixes into main 2026-10-03 15:40:15 +00:00
Member

Adds some basic guidance and link to the generic page for RPM instructions. The page itself didn't provide these steps before leading to some thinking the service works OOTB.

Pull request checklist:

  • This pull request targets the main branch, and the branch is named something other than
    main.
  • I have written an appropriate pull request title and my description is clear.
  • I understand I am responsible for the contents of this pull request.
  • I have followed the contributing guidelines:
Adds some basic guidance and link to the generic page for RPM instructions. The page itself didn't provide these steps before leading to some thinking the service works OOTB. <!-- Example: This pull request allows us to warp through time and space ten times faster than before by double-inverting the warp drive with hyperheated jump fluid, both making the drive faster and more efficient. This resolves the common issue where we have to wait more than 10 milliseconds to engage, use, and disengage the warp drive when travelling between galaxies. --> <!-- Closes: #... --> <!-- Fixes: #... --> <!-- Uncomment the above line(s) if your pull request fixes an issue or closes another pull request by superseding it. Replace `#...` with the issue/pr number, such as `#123`. --> **Pull request checklist:** <!-- You need to complete these before your PR can be considered. If you aren't sure about some, feel free to ask for clarification in #dev:continuwuity.org. --> - [x] This pull request targets the `main` branch, and the branch is named something other than `main`. - [x] I have written an appropriate pull request title and my description is clear. - [x] I understand I am responsible for the contents of this pull request. - I have followed the [contributing guidelines][c1]: - [x] My contribution follows the [code style][c2], if applicable. - [x] I ran [pre-commit checks][c1pc] before opening/drafting this pull request. - [x] I have [tested my contribution][c1t] (or proof-read it for documentation-only changes) myself, if applicable. This includes ensuring code compiles. - [x] My commit messages follow the [commit message format][c1cm] and are descriptive. <!-- Notes on these requirements: - While not required, we encourage you to sign your commits with GPG or SSH to attest the authenticity of your changes. - While we allow LLM-assisted contributions, we do not appreciate contributions that are low quality, which is typical of machine-generated contributions that have not had a lot of love and care from a human. Please do not open a PR if all you have done is asked ChatGPT to tidy up the codebase with a +-100,000 diff. - In the case of code style violations, reviewers may leave review comments/change requests indicating what the ideal change would look like. For example, a reviewer may suggest you lower a log level, or use `match` instead of `if/else` etc. - In the case of code style violations, pre-commit check failures, minor things like typos/spelling errors, and in some cases commit format violations, reviewers may modify your branch directly, typically by making changes and adding a commit. Particularly in the latter case, a reviewer may rebase your commits to squash "spammy" ones (like "fix", "fix", "actually fix"), and reword commit messages that don't satisfy the format. - Pull requests MUST pass the `Checks` CI workflows to be capable of being merged. This can only be bypassed in exceptional circumstances. If your CI flakes, let us know in matrix:r/dev:continuwuity.org. - Pull requests have to be based on the latest `main` commit before being merged. If the main branch changes while you're making your changes, you should make sure you rebase on main before opening a PR. Your branch will be rebased on main before it is merged if it has fallen behind. - We typically only do fast-forward merges, so your entire commit log will be included. Once in main, it's difficult to get out cleanly, so put on your best dress, smile for the cameras! --> [c1]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md [c2]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/docs/development/code_style.mdx [c1pc]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#pre-commit-checks [c1t]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#running-tests-locally [c1cm]: https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#commit-messages
stratself changed title from docs(rpm): Add basic configuration instructions to docs: Add basic configuration instructions for RPM page 2026-09-22 12:37:56 +00:00
silversys requested changes 2026-09-22 12:41:22 +00:00
Dismissed
@ -11,3 +11,3 @@
Available for upstream-supported Fedora versions (including compatible distributions, such as Ultramarine Linux) and Rawhide through Terra.
</Tab>
<Tab label="EL">
<Tab label="Enterprise Linux">
Member

I disagree that EL should be replaced with Enterprise Linux, a lot of other software I've seen (can't think of any examples off the top of my head) refers to this family of distros as just EL as it's a lot simpler.

I disagree that EL should be replaced with Enterprise Linux, a lot of other software I've seen (can't think of any examples off the top of my head) refers to this family of distros as just EL as it's a lot simpler.
Author
Member

SFLR. I'll revert accordingly.

SFLR. I'll revert accordingly.
stratself marked this conversation as resolved
@ -126,0 +133,4 @@
### Uninstallation
To uninstall Continuwuity:
Member

I don't think we need a guide on uninstalling, as none of the other installation methods have this either

I don't think we need a guide on uninstalling, as none of the other installation methods have this either
Author
Member

I'd like to add uninstalling guides to other deployment methods as well

I'd like to add uninstalling guides to other deployment methods as well
Member

Can i ask why? It seems excessive imo, and I can't remember seeing any other self-hosted project that includes removal guides

Can i ask why? It seems excessive imo, and I can't remember seeing any other self-hosted project that includes removal guides
Author
Member

Jellyfin has some uninstalling guides. It's just nice to have the information handy in general, and it'll be in the optional appendices anyways so low-priority. I'll add what I know for my deployment methods and hope others follow suit but it's not a requirement

Furthermore this section was copypasted from the old docs anyways, and deprioritized to the Appendix section. Since it's already there I don't see a point yeeting it off

Jellyfin has some [uninstalling guides](https://jellyfin.org/search/?q=uninstall). It's just nice to have the information handy in general, and it'll be in the optional appendices anyways so low-priority. I'll add what I know for my deployment methods and hope others follow suit but it's not a requirement Furthermore this section was copypasted from the [old docs](https://continuwuity.org/deploying/rpm.html#:~:text=Uninstallation) anyways, and deprioritized to the Appendix section. Since it's already there I don't see a point yeeting it off
Member

Fair enough

Fair enough
stratself marked this conversation as resolved
stratself force-pushed stratself/docs-rpm-fixes from d5169f07c3
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Auto Labeler / Apply labels based on changed files (pull_request_target) Successful in 3s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 6s
Checks / Prek / Check changed files (pull_request) Successful in 7s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m34s
to c24c5362db
Some checks failed
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 22s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 1m30s
2026-09-23 09:25:20 +00:00
Compare
stratself force-pushed stratself/docs-rpm-fixes from c24c5362db
Some checks failed
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 22s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 1m30s
to f619660bea
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m10s
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m56s
2026-09-26 16:09:54 +00:00
Compare
stratself force-pushed stratself/docs-rpm-fixes from f619660bea
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m10s
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m56s
to cec7248e58
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 26s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m7s
2026-09-26 16:11:31 +00:00
Compare
stratself force-pushed stratself/docs-rpm-fixes from cec7248e58
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 26s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m7s
to 3210f099ea
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m10s
2026-09-26 16:48:49 +00:00
Compare
lveneris requested changes 2026-09-26 22:54:46 +00:00
Dismissed
@ -72,2 +72,3 @@
## Configuration
**Systemd service commands**
Consult the [generic deployment instructions](./generic.mdx) for detailed steps. At the minimum, you will need to edit the [config file](../configuration.mdx) located at `/etc/conduwuit/conduwuit.toml` to your needs, and configure a [reverse proxy](./generic.mdx#setting-up-the-reverse-proxy).
Member

"You will at least need to adjust the config file located at /etc/conduwuit/continuwuity.toml to suit your needs, and configure a reverse proxy."

"You will at least need to adjust the config file located at `/etc/conduwuit/continuwuity.toml` to suit your needs, and configure a reverse proxy."
lveneris marked this conversation as resolved
stratself force-pushed stratself/docs-rpm-fixes from 3210f099ea
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m10s
to 38acd9c7d0
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 8s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m10s
Update flake hashes / update-flake-hashes (pull_request) Successful in 1m43s
2026-09-27 04:48:53 +00:00
Compare
lveneris approved these changes 2026-09-27 07:55:35 +00:00
silversys approved these changes 2026-09-27 16:18:38 +00:00
julian45 requested changes 2026-09-28 01:36:57 +00:00
Dismissed
julian45 left a comment

One small nitpick, otherwise LGTM

One small nitpick, otherwise LGTM
@ -72,2 +72,3 @@
## Configuration
**Systemd service commands**
Consult the [generic deployment instructions](./generic.mdx) for detailed steps. You will at least need to adjust the config file located at `/etc/conduwuit/continuwuity.toml` to suit your needs, and configure a [reverse proxy](./generic.mdx#setting-up-the-reverse-proxy).
Member

SFLR. The config file is still at conduwuit.toml for all RPM-packaged distros for as long as #1536 remains unresolved.

SFLR. The config file is still at **conduwuit**.toml for all RPM-packaged distros for as long as #1536 remains unresolved.
stratself marked this conversation as resolved
stratself force-pushed stratself/docs-rpm-fixes from 8dc33289cd
Some checks failed
Checks / Changelog / Check changelog is added (pull_request_target) Has been cancelled
Documentation / Build and Deploy Documentation (pull_request) Has been cancelled
Checks / Prek / Pre-commit & Formatting (pull_request) Has been cancelled
Checks / Prek / Check changed files (pull_request) Has been cancelled
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been cancelled
to 42073c22b5
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 7s
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m16s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
2026-09-28 02:08:46 +00:00
Compare
julian45 approved these changes 2026-09-28 02:25:23 +00:00
julian45 left a comment

LGTM :neobot:

LGTM :neobot:
stratself force-pushed stratself/docs-rpm-fixes from 42073c22b5
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 7s
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m16s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
to c3e7d7530f
All checks were successful
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 7s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 6s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m12s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
2026-10-01 18:51:46 +00:00
Compare
Henry-Hiles approved these changes 2026-10-01 19:38:07 +00:00
Dismissed
docs(rpm): Remove instructions to disable GPG checking
All checks were successful
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Check changed files (pull_request) Successful in 5s
Checks / Prek / Clippy and Cargo Tests (pull_request) Has been skipped
Checks / Changelog / Check changelog is added (pull_request_target) Successful in 11s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 1m11s
504e7b9320
Aranjedeath referenced this pull request from a commit 2026-10-03 15:40:16 +00:00
Sign in to join this conversation.
No milestone
No assignees
6 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
continuwuation/continuwuity!2275
No description provided.