Skip to content
Switch branches/tags


Translation status

Note: this is the work-in-progress installer and has not been released yet. For the current installer, see Ubiquity.

An installer for open-source operating systems. See the wiki for goals, design spec, user flow, and details about each step.

Building, Testing, and Installation

You'll need the following dependencies:

  • meson
  • desktop-file-utils
  • gettext
  • gparted
  • libgnomekbd-dev
  • libgranite-dev >= 0.5
  • libgtk-3-dev
  • libgee-0.8-dev
  • libhandy-1-dev
  • libjson-glib-dev
  • libpwquality-dev
  • libxml2-dev
  • libxml2-utils
  • distinst
  • valac

Run meson build to configure the build environment. Change to the build directory and run ninja test to build and run automated tests.

meson build --prefix=/usr
cd build
ninja test

To install, use ninja install, then execute with io.elementary.installer. Note that listing drives and actually installing requires root.

sudo ninja install

You can also use --test mode for development to disable destructive behaviors like installing, restarting, and shutting down:

io.elementary.installer --test

For debug messages, set the G_MESSAGES_DEBUG environment variable, e.g. to all:

G_MESSAGES_DEBUG=all io.elementary.installer