extern
/
nixos-wiki-infra
mirror of https://github.com/Mic92/nixos-wiki-infra.git
1
0
Fork 1
Code Issues Packages Projects Releases Wiki Activity
This project contains everything to setup yourself a mirror of https://nixos.wiki/
232 Commits 5 Branches 31 Tags 548 KiB
Nix 66.9%
HCL 16.7%
Python 13.9%
Shell 2.5%
Go to file
Mic92 f96fce77ce [create-pull-request] automated change 2024-07-05 03:00:24 +00:00
.github/workflows chore(deps): update cachix/install-nix-action action to v27 2024-05-15 19:28:13 +00:00
checks fix nixos test 2023-12-27 15:24:40 +01:00
modules [create-pull-request] automated change 2024-07-05 03:00:24 +00:00
targets Retry a second time when a deployment fails once 2024-07-01 13:51:31 +00:00
terraform treefmt 2024-03-03 11:29:08 +01:00
.envrc add envrc 2024-02-09 12:02:11 +01:00
.envrc.private-template template: update hetzner cloud project id 2024-02-09 11:58:00 +01:00
.gitignore Put gitignore at the correct place 2024-02-12 11:09:58 +01:00
.mergify.yml update mergify 2024-06-16 17:08:12 +02:00
.sops.yaml update target name in .sops.yaml 2024-02-17 18:43:02 +01:00
LICENSE.md add license 2023-10-24 17:57:46 +02:00
README.md README.md: expand introduction 2024-06-22 17:01:12 -07:00
flake.lock update nixpkgs 2024-07-01 13:44:39 +00:00
flake.nix switch to nixos-unstable-small 2024-04-18 07:17:19 +02:00
oauth-permissions.png add oauth permissions picture 2024-04-02 10:42:00 +02:00
renovate.json renovate: enable nix 2024-04-03 13:02:16 +02:00

README.md

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: