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 -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 +``` + +### 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