
Template:Linux installer features
Jump to navigation
Jump to search
- Script Name Verification: The installer checks for valid script names, such as
dist-installer-cli
,virtualbox-installer
,
kicksecure-cli-installer-cli
,kicksecure-xfce-installer-cli
. - Command-Line Parsing: It parses any command-line options provided.
- System Requirements Check: The installer assesses if the system meets prerequisites like adequate disk space, RAM, and virtualization support. Users are informed if any of these criteria aren't met.
- Package Installation: Necessary packages for the script's operation, like
signify
,curl
,rsync
, andvboxmanage
(for VirtualBox users) are installed using the distribution's package manager (APT or DNF). - Repository Settings:
- Debian and Derivatives:
- For
bullseye
(oldstable
): Enables the Debianbackports
andfasttrack
repositories. - For
bookworm
(stable
): Same as above. - For
trixie
(testing
): Enables the Debianunstable
repository and configures APT pinning to prefer packages fromtesting
overunstable
so only VirtualBox gets installed fromunstable
and no other dependency packages are unnecessarily pulled fromunstable
. - For
sid
(unstable
): Installs from Debianunstable
repository.
- For
- Ubuntu: Installs from the Ubuntu repository. [1]
- Fedora and Derivatives: Enables the
virtualbox.org
(Oracle) repository. - Updates: The preferred repository for VirtualBox installation may vary in the future based on availability. Updated installers might fetch VirtualBox from the Debian
fasttrack
repository,virtualbox.org
(Oracle) repository, or the Kicksecure repository. development discussion: VirtualBox Integration and Upgrades)
- Debian and Derivatives:
- Version Querying: If no version is specified via command line, the Kicksecure version number is fetched using the API. (Only if installing Kicksecure.) (Not for
virtualbox-installer
. [2]) - Virtual Machine Handling:
- For previously imported VMs, users are prompted to boot the virtual system(s). (Not for
virtualbox-installer
. [2].) - For previously downloaded VM files, authenticity and integrity checks are run. (Not for
virtualbox-installer
. [2].) - For first-time users, the installer downloads the required files, conducts authenticity and integrity checks, imports the system(s), and then attempts to start the Virtual Machine(s). (Not for
virtualbox-installer
. [2].)
- For previously imported VMs, users are prompted to boot the virtual system(s). (Not for
- Inform user if VMs are already running and abort installation. (Not for
virtualbox-installer
. [2].)
Additional Features:
- Download Resumption: Utilizes
rsync
internally to enable download resumption capabilities. - Integrity Checking: Offers a streamlined integrity verification process, facilitated by
rsync
. - Download from Oracle Repository: When using
--oracle-repo
command line option, downloads VirtualBox from Oracle repository. This is the default for Fedora-based distributions. It's optional for Debian-based ones (including Ubuntu) but may be set by developers in the future if the Debian repository discontinues the VirtualBox package. The Oracle repository might at times provide a newer VirtualBox version. - Onion Support: Allows for downloads from onion sources with the
--onion
command line option whenever possible. (For example Oracle does not provide an onion repository.) - Default Download Directory: Files are saved in the
~/dist-installer-cli-download
folder. - Logging Mechanics: For transparency, every command executed is logged in the download directory, accompanied by the specific script version used at the time.
- Transparent System Modifications: The installer’s operations are evident to the user. All persistent system alterations, especially those executed with administrative ("root") privileges, are prominently detailed in the installer's output.
- Documentation: Comprehensive details can be found in the
dist-installer-cli
man page.
- Checks: Nested Virtualization, secure boot enabled check.
Developer Information:
- Source Code:
/usr/bin/dist-installer-cli
, Continuous Integration Testing
.github/workflows/builds.yml
- Development Wiki Page: Dev/Linux Installer
- Development Discussion: forums discussion
- Security: The
dist-installer-cli
script is not intended for curl bash piping. However, for a comprehensive discussion on security concerns related to this topic, see here.
Footnotes[edit]
- ↑
Might sound complicated but it's actually quite simple in case of Ubuntu. Install from the usual, "normal", official
packages.ubuntu.com
. From the usualsuite
. For example, if using suitejammy
, it installs fromjammy
. This is because Ubuntu is packaging VirtualBoxfor their usual stable suites. Debian doesn't. That's why Ubuntu does not require any special repository. (Debian required
backports
andfasttrack
repositories at time of writing.) - ↑ Jump up to: 2.0 2.1 2.2 2.3 2.4
Because that is not required if only installing VirtualBox using
virtualbox-installer
.)

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!