documentation/README.md

76 lines
1.7 KiB
Markdown
Raw Normal View History

2023-08-16 23:58:57 +02:00
# wiki.bijl.us
2023-08-16 17:44:51 +02:00
2023-08-17 00:01:27 +02:00
Documentation for the different projects and setups on [git.bijl.us](https://git.bijl.us).
2023-08-16 17:44:51 +02:00
2023-08-16 23:58:57 +02:00
To begin go to the [wiki](https://wiki.bijl.us)!
2023-08-16 21:06:54 +02:00
## Prerequisites
Install `mkdocs` through pip:
```
# xbps-install -Sy python3-devel python3-pip
2023-08-16 21:22:57 +02:00
$ pip install mkdocs mkdocs-material
2023-08-16 21:06:54 +02:00
```
2023-08-16 22:44:11 +02:00
This will put an executable in `~/.local/lib/python3.11/site-packages/mkdocs/__main__.py`
2023-08-16 21:06:54 +02:00
I would recommended creating an alias for using it. For example:
```
alias mkdocs="python ~/.local/lib/python3.11/site-packages/mkdocs/__main__.py"
```
2023-08-16 21:14:15 +02:00
## Building
2023-08-16 21:06:54 +02:00
2023-08-16 21:14:15 +02:00
Build the website through:
```
$ mkdocs build
```
And preview it with:
```
$ mkdocs serve
```
2023-08-16 21:22:57 +02:00
This will host the website locally on [http://127.0.0.1:8000/](http://127.0.0.1:8000/).
2023-08-17 00:32:31 +02:00
2023-08-17 00:34:36 +02:00
## To-Do for Void-Desktop
2023-08-17 00:32:31 +02:00
Important:
- [ ] Improving dotfiles of:
- [ ] SwayNC
- [ ] Tofi
- [ ] Wayfire decorations
- [ ] User packages
- [ ] Graphical package manager
- [ ] Firewall (ufw)
- [ ] User services (Turnstile backend)
- [ ] Default config and user groups automatically (no cloning of configs, (maybe a `.tar.gz` at root))
- [x] Automatic decryption through TPM (Clevis)
- [x] Clevis package
- [x] Booster werkende krijgen
- [ ] Hardenend kernel
- [ ] Sysctl optimisations
- [ ] Better luks encryption algoritm (faster)
- [ ] Better boot parameters
- [ ] Better partitioning (/usr, /proc etc their own partitions and also more secure root partition)
- [ ] Better polkit permisissions
- [ ] Applicatio sandboxing (bubblejail, bubblewrap, apparmor)
Less important:
- [ ] macchanger
- [ ] plymouth (for graphical boot up) (not possible with booster)
- [ ] ABRoot
Notes:
https://madaidans-insecurities.github.io/guides/linux-hardening.html#kernel