From 4172a74b5c71189ef0d6b0da68060f4a49986e11 Mon Sep 17 00:00:00 2001
From: ngn <ngn@ngn.tf>
Date: Tue, 27 Feb 2024 22:05:11 +0300
Subject: [PATCH] Adding details for /etc/hosts to the installation

---
 wiki/install/install.json |  2 +-
 wiki/install/install.md   | 25 +++++++++++++++----------
 wiki/install/post.json    |  2 +-
 wiki/install/post.md      |  7 ++++++-
 4 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/wiki/install/install.json b/wiki/install/install.json
index 1ec88a3..a133c28 100644
--- a/wiki/install/install.json
+++ b/wiki/install/install.json
@@ -2,5 +2,5 @@
   "id": "install",
   "title": "Installation",
   "author": "ngn",
-  "date": "22/02/24"
+  "date": "27/02/24"
 }
diff --git a/wiki/install/install.md b/wiki/install/install.md
index df70483..73d0c99 100644
--- a/wiki/install/install.md
+++ b/wiki/install/install.md
@@ -12,7 +12,7 @@ To load a key map, you can use the `loadkeys` command, for example:
 # loadkeys tr_q-latin5
 ```
 
-# Setting up the Installation Disk  
+# Setting up the installation disk  
 During the installation, the installation disk will be referred as `$DISK`. In order to 
 copy paste commands easily, you can set this as an environment variable:
 ```
@@ -82,27 +82,27 @@ After downloading and verifying the archive extract it to the `/mnt` directory:
 # tar xvf <archive name> -C /mnt
 ```
 
-### Package Manager Configuration
+### Package manager configuration
 Copy over the `mp` configuration to the new system:
 ```
 # cp /etc/mp/cfg /mnt/etc/mp/cfg
 ```
 
-### Change Root
+### Change root
 To change root (`chroot`) into the new system, you can use the `matter-chroot` tool, which is a part of [MatterLinux `tools`
 project](https://git.matterlinux.xyz/Matter/tools): 
 ```
 # matter-chroot /mnt 
 ```
 
-### Setup Timezone
+### Setup timezone
 Link `/etc/localtime` to your localtime zone. Timezones are located under 
 `/usr/share/zoneinfo`. For example:
 ```
 # ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime
 ```
 
-### Setup Locales
+### Setup locales
 List all the avaliable locales with `locale -a`, then place the locale you want into the 
 `/etc/locale.gen` file with the following format:
 ```
@@ -118,8 +118,7 @@ into the `/etc/locale.conf` file, for example:
 # echo "LANG=en_US.UTF-8" > /etc/locale.conf
 ```
 
-
-### Installing Important Packages 
+### Installing important packages 
 After changing root, you can now start installing other base system packages that are not included in the release archive. 
 But first thing first, sync all the packages and add the repo public keys:
 ```
@@ -147,7 +146,13 @@ $BOOT        /boot         ext4          defaults     0       0
 ```
 Change the configuration accordingly. 
 
-### Changing the Root Password
+### Editing the hosts file
+Add your hostname to the `/etc/hosts` file, right beside `127.0.0.1`:
+```
+127.0.0.1   localhost <hostname>
+```
+
+### Changing the root password
 Change your root password:
 ```
 # passwd
@@ -174,7 +179,7 @@ For the grub BIOS installation, install the `grub-bios` package:
 > For the grub UEFI installation, install the `grub-efi` package
 > instead of `grub-bios`
 
-### Installation and Configuration
+### Installation and configuration
 To install grub to your boot partition, run:
 ```
 # grub-install $DISK
@@ -185,7 +190,7 @@ To auto generate grub configuration, run:
 # grub-mkconfig -o /boot/grub/grub.cfg
 ```
 
-# Cleanup and Reboot 
+# Cleanup and reboot 
 Exit the `chroot` environment and `umount` all the disks:
 ```
 # umount $BOOT
diff --git a/wiki/install/post.json b/wiki/install/post.json
index b0b5ee9..d424e84 100644
--- a/wiki/install/post.json
+++ b/wiki/install/post.json
@@ -2,5 +2,5 @@
   "id": "post_install",
   "title": "Post-Installation",
   "author": "ngn",
-  "date": "22/01/24"
+  "date": "27/01/24"
 }
diff --git a/wiki/install/post.md b/wiki/install/post.md
index fb2b1e0..74f6a91 100644
--- a/wiki/install/post.md
+++ b/wiki/install/post.md
@@ -38,6 +38,11 @@ Lastly edit the doas confiuration (`/etc/doas.conf`) to give access to the `whee
 ```
 # echo "permit keepenv :wheel" > /etc/doas.conf
 ```
+> **Why keepenv?**
+>
+> MatterLinux package manager has options such as `MP_YES` that are set with environment 
+> variables. To make sure that these options work `keepenv` needs to be added to the doas 
+> confiuration.
 
 ## Installing XORG
 Xorg can be installed using a simple wrapper package:
@@ -51,7 +56,7 @@ To easily install a desktop, you can use the `xcfg` tool:
 ```
 # mp-install xcfg
 ```
-You can then use the tool as a regular user, not that you will need access to the `doas` (or `sudo`) command 
+You can then use the tool as a regular user, not that you will need access to the `doas` command 
 in order to use the tool:
 ```
 $ xcfg