qusal/salt/kicksecure-minimal
Ben Grande f9ead06408 fix: remove extraneous package repository updates
Updates happens multiple times, normally 2 to 3, even if we consider a
state without includes. On states with multiple includes, it could
easily get approximately 10 updates being ran. This behavior leads to
unnecessary network bandwidth being spent and more time to run the
installation state. When the connection is slow and not using the
cacher, such as torified connections on Whonix, the installation can
occurs much faster.

Adding external repositories has to be done prior to update to ensure it
is also fetched.

Fixes: https://github.com/ben-grande/qusal/issues/29
2024-03-18 17:51:36 +01:00
..
files fix: less intrusive kicksecure default install 2024-02-01 17:40:26 +01:00
clone.sls chore: copyright update 2024-01-29 16:49:54 +01:00
clone.top chore: copyright update 2024-01-29 16:49:54 +01:00
create.sls fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
create.top chore: copyright update 2024-01-29 16:49:54 +01:00
init.top chore: copyright update 2024-01-29 16:49:54 +01:00
install-developers.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-developers.top fix: less intrusive kicksecure default install 2024-02-01 17:40:26 +01:00
install-repo.sls chore: copyright update 2024-01-29 16:49:54 +01:00
install-repo.top chore: copyright update 2024-01-29 16:49:54 +01:00
install.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install.top chore: copyright update 2024-01-29 16:49:54 +01:00
kernel-default.sls fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
kernel-default.top fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
kernel-hvm.sls fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
kernel-hvm.top fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
kernel-pv.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
kernel-pv.top fix: vm kernel only applies to developers 2024-02-03 20:58:28 +01:00
prefs.sls chore: copyright update 2024-01-29 16:49:54 +01:00
prefs.top chore: copyright update 2024-01-29 16:49:54 +01:00
README.md doc: prefix qubesctl with sudo 2024-02-23 16:55:11 +01:00
template.jinja chore: copyright update 2024-01-29 16:49:54 +01:00

kicksecure-minimal

Kicksecure Minimal Template in Qubes OS.

Table of Contents

Description

Creates the Kicksecure Minimal template as well as a Disposable Template based on it.

Installation

  • Top:
sudo qubesctl top.enable kicksecure-minimal
sudo qubesctl --targets=kicksecure-17-minimal state.apply
sudo qubesctl top.disable kicksecure-minimal
sudo qubesctl state.apply kicksecure-minimal.prefs
  • State:
sudo qubesctl state.apply kicksecure-minimal.create
sudo qubesctl --skip-dom0 --targets=kicksecure-17-minimal state.apply kicksecure-minimal.install
sudo qubesctl state.apply kicksecure-minimal.prefs

Kicksecure Developers Installation

If you want to help improve Kicksecure integration on Qubes, install packages that are known to be broken on Qubes and can break the boot of the Kicksecure Qube, to report bugs upstream (get a terminal with qvm-console-dispvm):

sudo qubesctl --skip-dom0 --targets=kicksecure-17-minimal state.apply kicksecure-minimal.install-developers

Choose the kernel according to the virt_mode you want for the template:

  • hvm:
sudo qubesctl state.apply kicksecure-minimal.kernel-hvm
  • pvh:
sudo qubesctl state.apply kicksecure-minimal.kernel-pv
  • Dom0 provided kernel (resets virt_mode to pvh):
sudo qubesctl state.apply kicksecure-minimal.kernel-default

Usage

AppVMs and StandaloneVMs can be based on this template.

Kicksecure Developers Usage

This is intended for Kicksecure Developers to test known to be broken hardening measures. It is not intended for other developers or users.

After you have ran the developers SaltFile, when reporting bugs upstream, share the following information of the customizations made by this formula:

  • hardened-malloc:
libhardened_malloc.so
  • hide-hardware-info:
sysfs_whitelist=0
cpuionfo_whitelist=0
  • permission-hardener:
whitelists_disable_all=true