mirror of
https://github.com/Mic92/nixos-wiki-infra.git
synced 2024-11-23 08:43:11 +01:00
This project contains everything to setup yourself a mirror of https://nixos.wiki/
.github/workflows | ||
checks | ||
modules | ||
targets | ||
terraform | ||
.envrc | ||
.envrc.private-template | ||
.gitignore | ||
.mergify.yml | ||
.sops.yaml | ||
flake.lock | ||
flake.nix | ||
formatter.nix | ||
LICENSE.md | ||
oauth-permissions.png | ||
README.md | ||
renovate.json |
nixos-wiki-infra
This project contains the setup of the official NixOS Wiki (wiki.nixos.org).
Additionally,
this project's GitHub Issues
host a space for coordination and discussion of wiki activities, in tandem with
the Matrix channel #wiki:nixos.org
.
Examples
Checkout ./targets/nixos-wiki.nixos.org for an example terraform deployment on hetzner cloud.
Downloading a dump of the wiki
This is useful if you want to run your own instance. Every day an XML dump is updated here:
https://wiki.nixos.org/wikidump.xml.zst
Restoring from a backup (wiki admins only)
$ systemctl stop phpfpm-mediawiki.service
$ borg-job-wiki list
$ borg-job-wiki mount u391032-sub1@u391032.your-storagebox.de:wiki.nixos.org/repo::wiki-wiki-2024-04-01T12:40:37 /tmp/restore
$ ls -la /tmp/restore/var/lib/mediawiki/backup/
$ sudo dropdb db
$ sudo -u postgres dropdb mediawiki
$ systemctl restart postgresql.service
$ sudo -u postgres pg_restore -d mediawiki < /tmp/restore/var/lib/mediawiki/backup/db
$ systemctl start phpfpm-mediawiki.service
$ ls -la /tmp/restore/var/lib/mediawiki-uploads/
$ umount /tmp/restore/
FAQ:
When logging in with "GitHub auth", the app shows "Act on your behalf" as a permission.
We created the Oauth app with read-only access and minimal permissions:
Unfortunately, GitHub misrepresents this information. Read more about this issue here: https://github.com/orgs/community/discussions/37117
Roles
Various roles are present on the wiki:
- Bureaucrats can assign roles to others. (members, permissions)
- Administrators can perform almost all restricted actions. (members, permissions)
- Moderators can perform a limited subset of restricted actions. (members, permissions)
- Trusted users can perform page deletions. (members, permissions)