# 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.

Warning: The Hawaii desktop environment has not reached its stable 1.0 release.

## Installation

Install hawaii-meta-gitAUR from the Arch User Repository.

## Run with a graphical login manager

Login managers that support Wayland such as sddm and gdm can run a Hawaii session.

## Run from a tty

Log in to a tty and type:

    $ hawaii-session

The session manager automatically detects the hardware and will run the compositor accordingly.

However the mode can be forced, for example to force nested mode and run inside Weston:

    $ hawaii-session --mode=nested

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 with systemd user session

First you need to setup D-Bus with systemd user session as examplained on Systemd/User#D-Bus. Then enable the hawaii.service unit with:

    $ systemctl --user enable hawaii.service

Every time you want to start a Hawaii session:

    $ systemctl --user isolate hawaii.target

logind integration is know not to work with systemd user session at the moment, hence some features might not be working. systemd user session is pretty new and the developers are testing Hawaii with it.

## Tips and tricks

### Portable keybindings

To export your keyboard shortcut keys, you should do:

    $ dconf dump /org/hawaiios/desktop/keybindings/ > keybindings-backup.dconf

To later import it (for example) on another computer, do:

    $ dconf load /org/hawaiios/desktop/keybindings/ < keybindings-backup.dconf

## See also

- http://hawaiios.org Official Web site
- https://github.com/hawaii-desktop Hawaii's github page

Category:

- Desktop environments