matter/content
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Adding details for /etc/hosts to the installation

Browse Source
This commit is contained in:
ngn 2024-02-27 22:05:11 +03:00
parent 7b78e6ffc1
commit 4172a74b5c
4 changed files with 23 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
wiki/install/install.json
View File

@ -2,5 +2,5 @@
"id": "install", "id": "install",
"title": "Installation", "title": "Installation",
"author": "ngn", "author": "ngn",
"date": "22/02/24" "date": "27/02/24"
} }

25
wiki/install/install.md
View File

@ -12,7 +12,7 @@ To load a key map, you can use the `loadkeys` command, for example:
# loadkeys tr_q-latin5 # 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 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: 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 # tar xvf <archive name> -C /mnt
``` ```
### Package Manager Configuration ### Package manager configuration
Copy over the `mp` configuration to the new system: Copy over the `mp` configuration to the new system:
``` ```
# cp /etc/mp/cfg /mnt/etc/mp/cfg # 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` 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): project](https://git.matterlinux.xyz/Matter/tools):
``` ```
# matter-chroot /mnt # matter-chroot /mnt
``` ```
### Setup Timezone ### Setup timezone
Link `/etc/localtime` to your localtime zone. Timezones are located under Link `/etc/localtime` to your localtime zone. Timezones are located under
`/usr/share/zoneinfo`. For example: `/usr/share/zoneinfo`. For example:
``` ```
# ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime # 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 List all the avaliable locales with `locale -a`, then place the locale you want into the
`/etc/locale.gen` file with the following format: `/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 # 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. 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: 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. 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: Change your root password:
``` ```
# passwd # 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 > For the grub UEFI installation, install the `grub-efi` package
> instead of `grub-bios` > instead of `grub-bios`
### Installation and Configuration ### Installation and configuration
To install grub to your boot partition, run: To install grub to your boot partition, run:
``` ```
# grub-install $DISK # grub-install $DISK
@ -185,7 +190,7 @@ To auto generate grub configuration, run:
# grub-mkconfig -o /boot/grub/grub.cfg # grub-mkconfig -o /boot/grub/grub.cfg
``` ```
# Cleanup and Reboot # Cleanup and reboot
Exit the `chroot` environment and `umount` all the disks: Exit the `chroot` environment and `umount` all the disks:
``` ```
# umount $BOOT # umount $BOOT

2
wiki/install/post.json
View File

@ -2,5 +2,5 @@
"id": "post_install", "id": "post_install",
"title": "Post-Installation", "title": "Post-Installation",
"author": "ngn", "author": "ngn",
"date": "22/01/24" "date": "27/01/24"
} }

7
wiki/install/post.md
View File

@ -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 # 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 ## Installing XORG
Xorg can be installed using a simple wrapper package: 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 # 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: in order to use the tool:
``` ```
$ xcfg $ xcfg