# Build instructions

NOTE: Lomiri depends on packages from [Gentoo GURU Project⬀][guru]

1. **Switch to** [systemd⬀][sysd] init system or use [stage3-amd64-systemd⬀][s3] tarball.

2. **Add all needed overlays** using [eselect-repository⬀][erepo] module and synchronize it:

   `eselect repository enable gentoo-lomiri`
   <br/>
   `eselect repository enable guru`
   <br/>
   `emaint sync -r gentoo-lomiri`
   <br/>
   `emaint sync -r guru`

   NOTE: Package [dev-vcs/git⬀][git] is required.

3. **Set** `gentoo-lomiri:amd64/23.0/desktop/lomiri/systemd (exp)` [profile⬀][ep] listed with `eselect profile list`.

4. **Setup** Gentoo Lomiri Desktop **build environment**:

   `emerge -av lomiri-base/gentoo-lomiri-env`

5. **Update the whole system**:

   `emerge -avuDU --with-bdeps=y @world`

6. **Install the** Gentoo Lomiri Desktop:

   `emerge -av lomiri-meta`

#

NOTES:

- Don't forget to start systemd services, such as [LightDM⬀][ldm], [NetworkManager⬀][nm], [CUPS⬀][cups] or [Bluetooth⬀][bt].

- If you switch the default Python target, you **must** update `sys-apps/portage` before any other packages.

- Qt5 is slowly on its way out in Gentoo [Bug #948836⬀][qt5]

[//]: # (LINKS)
[bt]: https://wiki.gentoo.org/wiki/Bluetooth#systemd
[cups]: https://wiki.gentoo.org/wiki/Printing#systemd
[ep]: https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Base#Choosing_the_right_profile
[erepo]: https://wiki.gentoo.org/wiki/Eselect/Repository
[git]: https://wiki.gentoo.org/wiki/Git
[guru]: https://wiki.gentoo.org/wiki/Project:GURU
[ldm]: https://wiki.gentoo.org/wiki/LightDM#systemd
[nm]: https://wiki.gentoo.org/wiki/NetworkManager#systemd
[qt5]: https://bugs.gentoo.org/948836
[s3]: https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Stage#Downloading_the_stage_file
[sysd]: https://wiki.gentoo.org/wiki/Systemd