# Hawaii

Related articles

- Wayland
- Desktop environment
- Display manager
- Window manager
- Qt

From phoronix.com:

  The Hawaii Desktop is looking to be the very first Wayland-friendly desktop environment for Linux. The Hawaii desktop is the product of the Maui OS team, a Linux distribution that's trying to avoid traditional packages and instead provide a minimal image with the Linux kernel, systemd, ConnMan, and other core components, while being powered by a Wayland desktop.

Note: The hawaii desktop environment has not reached its stable 1.0 release. The latest version is 0.2.0. It may not work properly on your system.

## Installation

Install hawaii-meta-git from the AUR.

Alternatively, you can use the upstream binary package for hawaii. It is recommended to install the upstream binary from the official Maui site: http://www.maui-project.org/download/

The latest details from the upstream site warns that Mesa 10.1 might crash Hawaii. If this happens to you, use the Arch roll back machine to install Mesa 10.0.3. The packages that one needs to downgrade are mesa, mesa-libgl and *-dri (for example intel-dri for Intel GPUs).

After you have downgraded Mesa and the relevant packages, add those down graded packages to the ignore section in `/ect/pacman.conf`

    /etc/pacman.conf

    IgnorePkg = mesa mesa-libgl intel-dri

Add the upstream respository to `/etc/pacman.conf`.

    /etc/pacman.conf

    Server = http://archive.maui-project.org/archlinux/$repo/os/$arch
    SigLevel = Optional TrustAll

Install hawaii and its dependencies with `pacman -Syu hawaii-meta-git`

Install more packages with

`pacman -Syu communi-desktop-git qupzilla-qt5-git sddm-qt5-git`

Note: If you use this binary package, then the hawaii binary will be stored in `/opt/hawaii-git/bin/hawaii`
Note: The current upstream binary package only supports the x86_64 architecture.

## Run hawaii

Change the following variables in /opt/qt5/qml, be aware that this is not what they file may look like, but instead what certain variables should look like {{/opt/qt5/qml

### Without login manager

To run hawaii without a login manager, add `systemctl start hawaii` to the startup script of your choice.

Note: Do not use ~/.xinitrc to start hawaii. Xinit is commonly used to start Xorg, but hawaii uses Wayland, which is a newer graphical protocol.

## Run Hawaii Applications without the Hawaii Shell

Install hawaii-qt5-wayland-git, libhawaii-git, hawaii-widget-styles-git.

    $ export QML2_IMPORT_PATH=/usr/local/lib/hawaii/qml

Also

    $ export QT_QPA_PLATFORM=wayland-egl

This page also seems helpful.

## See also

- http://www.maui-project.org/ Maui Linux OS website
- https://github.com/mauios/hawaii Hawaii's github page

Category:

- Desktop environments