docs: cleanup README

This commit is contained in:
Matthieu Bessat 2024-08-02 14:00:19 +02:00
parent e788fa6ef8
commit 82164be2e2
6 changed files with 33 additions and 112 deletions

104
README.md
View file

@ -4,13 +4,9 @@ Code name given on 2024-05-16 : "MonakhOS"
Architecture:
- Sway
- Support of dots file repository
- A single `venv` in dots containing all utilities and libs
## Ansible
https://github.com/id101010/ansible-archlinux
## Getting started with a VM (qemu)
Cd in `sandbox_vms/vm1`
@ -35,15 +31,19 @@ Create snapshot to be able to quickly restart the ansible script with a clean im
qemu-img create -f qcow2 -b after_ssh_init.img -F qcow2 ready_for_ansible.img
## Steps to install
- find a new name for the device eg. blackjack
- connect to wifi
- enable ssh server to access it from the exterior
- generate ssh key
- add sshkey to forge.lefuturiste.fr
- install with `archinstall` to initialize the computer
- use the profiles defined in `archinstall_configs`
- connect to the internet
- enable an ssh server to access it from the ansible runner host
- on the host, generate a private ssh key
- add the public key on the target host
- create a target directory in `target` directory
- configure `vars.yaml`, see example vars file
- create on the host, the private ssh key that will be installed on target
- add this sshkey to your forge that host your dots file, eg. forge.lefuturiste.fr
### Generate a unprotected default ssh key
@ -74,86 +74,14 @@ Host aur.archlinux.org
User aur
```
### Clone dots
```
cd ~
git clone git@forge.lefuturiste.fr:mbess/dots .dots
```
```
cd ~/.dots
python3 -m venv venv
pip install -r requirements.txt
# create symbolic link to access dots
ln -s ~/.dots ~/dots
```
### install yay
```
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
```
### configure Zsh
https://wiki.archlinux.org/title/Zsh
### configure xremap
sudo systemctl daemon-reload
sudo systemctl enable --now xremap
### Import and configure GPG keys
### Configure unix password manager
using `extra/gopass`
### Setup symbolic links to configs files
run the script `setup_dot.sh`
## Shell
### Fish
#### install fisher
https://github.com/jorgebucaran/fisher
use `fisher package`
#### fzf fish
https://github.com/PatrickF1/fzf.fish
require fd and bat
#### lfcd
https://github.com/gokcehan/lf/blob/master/etc/lfcd.fish
### Zsh
https://yewtu.be/watch?v=ud7YxC33Z3w
https://github.com/jeffreytse/zsh-vi-mode
How to handle different profiles
## Pacman packages
defined in dots file
arch_packages.yaml
categories: commons, work
## Sway
### swayidle
@ -166,7 +94,7 @@ Ly is a TUI greeter, it will show a terminal based login prompt
https://github.com/fairyglade/ly
## ansible
## Ansible
### auto run archinstall with ansible
@ -174,8 +102,8 @@ https://github.com/fairyglade/ly
https://archinstall.archlinux.page/
## Pistes
https://github.com/kewlfft/ansible-aur
- https://github.com/id101010/ansible-archlinux
- https://github.com/kewlfft/ansible-aur