Template:Build Documentation Build Configuration

From Kicksecure
Revision as of 14:45, 18 July 2024 by Patrick (talk | contribs) (Created page with "<noinclude>{{Header}}</noinclude> <div class="toccolours mw-collapsible mw-collapsed"> It is possible to add build configuration files snippets which can change build variables. <div class="mw-collapsible-content"> <u>Build Configuration Folders</u>: You can drop configuration file either in: # <code>buildconfig.d</code> or in # <code>/etc/buildconfig-dist.d</code> # <code>../buildconfig.d</code> folder. Files should have the file extension <code>.conf</code></code>....")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

It is possible to add build configuration files snippets which can change build variables.

Build Configuration Folders:

You can drop configuration file either in:

  1. buildconfig.d or in
  2. /etc/buildconfig-dist.d
  3. ../buildconfig.d folder.

Files should have the file extension .conf.

Method 2. is recommended for users.

  1. Contains examples. It is more difficult to use. [1] Rather use the following.
  2. sudo mkdir --parents /etc/buildconfig-dist.d
  3. When /home/user/Kicksecure is your Kicksecure source folder, you could use /home/user/buildconfig.d as your Kicksecure build configuration folder. It is easier to use, since you don't have to git commit your build config files.

[2]

Below is an example how to use method 2.

sudo mkdir /etc/buildconfig-dist.d

Open file /etc/buildconfig-dist.d/50_user.conf in an editor with root rights.

Kicksecure

See Open File with Root RightsOnion network Logo for detailed instructions on why to use sudoedit for better security and how to use it.

Note: Mousepad (or the chosen text editor) must be closed before running the sudoedit command.

sudoedit /etc/buildconfig-dist.d/50_user.conf

Kicksecure for Qubes

NOTES:

sudoedit /etc/buildconfig-dist.d/50_user.conf

  • After applying this change, shutdown the Template.
  • All App Qubes based on the Template need to be restarted if they were already running.
  • This is a general procedure required for Qubes and unspecific to Kicksecure for Qubes.

Others and Alternatives

  • This is just an example. Other tools could achieve the same goal.
  • If this example does not work for you or if you are not using Kicksecure, please refer to this link.

sudoedit /etc/buildconfig-dist.d/50_user.conf

Add. (Replace it with whatever build configuration variable you wish to set.)

Example 1.

export DERIVATIVE_APT_REPOSITORY_OPTS='--enable --repository stable'

Example 2.

export tbb_version=13.0.1

Save.

Done.

Notification image

We believe security software like Kicksecure needs to remain Open Source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!

  1. Since you would have to either:
    • A) git commit your build config files, OR,
    • B) See chapter source code changes below.
  2. This is because .. means "one level below this folder".