Calamares: Distribution-Independent Installer Framework

---

Report a Bug	Contribute	Translate	Freenode (IRC): #calamares

Dependencies

Compiler with C++11 support: GCC >= 4.9.0 or Clang >= 3.5.1

Main	Welcome module	Partitioning module	Bootloader module	Unpackfs module
CMake >= 2.8.12	NetworkManager	extra-cmake-modules	systemd-boot or GRUB2	squashfs-tools
Qt >= 5.3	UPower	kconfig (part of KF5)	sgdisk	rsync
yaml-cpp >= 0.5.1		solid (part of KF5)
Python >= 3.3		kcoreaddons (part of KF5)
Boost.Python >= 1.55.0		ki18n (part of KF5)
dmidecode		sgdisk

Deployment

Setting up branding

Working with modules

Building

Clone Calamares from GitHub and cd into the calamares directory, then:

$ git submodule init
$ git submodule update
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Debug ..
$ make

Supported variables for CMake

• WITH_PYTHON - if this is set to false, the Python module interface will not be built. Default is true.
• SKIP_MODULES - takes a space-separated list of module names that should not be built even if present in src/modules (e.g. cmake -DSKIP_MODULES="partition mount umount welcome" ..). Default is empty.

Design Notes

Calamares is currently split as follows:

1. libcalamares - The back-end library.

• Only depends on QtCore, yaml-cpp, Python and Boost.Python.
• Provides a job queue and generic jobs.
• Comes with 3 job interfaces: C++, Python and process (the latter is very limited).

2. libcalamaresui - The front-end library.

• Same dependencies as libcalamares, plus QtWidgets and other Qt modules.
• Comes with a module loading system, for different kinds of plugins.
• Supports branding components.
• Presents a bunch of pages in a scripted order, enqueues jobs in the back-end library.

3. calamares - The main executable.

• A thin wrapper around libcalamaresui; starts up and plugs together all the parts.