Skip to main content

Installation from GURU

Mango is available in the community-maintained GURU repository for Gentoo.
1

Enable GURU repository

First, install eselect-repository if you don’t have it:
emerge --ask --verbose eselect-repository
2

Add and sync GURU

Enable the GURU repository and sync it:
eselect repository enable guru
emerge --sync guru
3

Accept keywords

Add the required packages to your package.accept_keywords file:
/etc/portage/package.accept_keywords/mango
gui-libs/scenefx ~amd64
gui-wm/mangowm ~amd64
Replace ~amd64 with your architecture if different (e.g., ~arm64).
4

Install Mango

Install the package with Portage:
emerge --ask --verbose gui-wm/mangowm
5

Launch Mango

After installation, you can start Mango from a TTY:
mango
Or select it from your display manager’s session list.

Dependencies

Portage will automatically install these dependencies:
  • wayland
  • wayland-protocols
  • libinput (>=1.27.1)
  • libdrm
  • libxkbcommon
  • pixman
  • libdisplay-info
  • libliftoff
  • hwdata
  • seatd
  • pcre2
  • xorg-xwayland
  • libxcb
  • wlroots (0.19.x)
  • scenefx (0.4.x)

Suggested Tools

Install additional tools for a complete Wayland environment:
emerge --ask rofi
# or
emerge --ask bemenu

Next Steps

Configuration

Configure Mango to your preferences

Keybindings

Learn default keybindings and create custom ones

Build docs developers (and LLMs) love