{{Header}} {{hide_all_banners}} {{Title|
title=Install {{project_name_long}} inside Debian
}}
{{#seo:
|description={{project_name_short}} can be installed on top of an existing Debian installation.
|image=Download-debian.jpg
}}
[[image:Download-debian.jpg|thumb]]
{{intro|
An existing Debian version {{Stable project version based on Debian version short}}
(codename: {{Stable project version based on Debian codename}}
) installation can be converted into [[About|{{project_name_short}}]] by installing a {{project_name_short}} deb package. This procedure is also called [[Distribution_Morphing|distro-morphing]].
There is no downloadable iso
yet but it will be available in the future. In the meantime install Debian on the host or inside a VM, then install {{project_name_short}} on top.
}}
= Introduction =
{{Disclaimer}}
To increase the chances of success, it is best to start with a minimal Debian installation either,
* A) Debian {{gui}} Xfce
* B) or Debian {{cli}}
and then install a {{project_name_short}} meta package as documented below.
It is easiest to set the Linux user account name to user
during the installation of Debian {{Stable project version based on Debian codename}}
.
= Prerequisites =
{{Prerequisites}}
= Installation =
== Add the {{project_name_short}} Repository ==
{{Project-APT-Repository-Add}}
== Install the {{project_name_short}} Package ==
{{Box|text=
'''1.''' Pick a {{project_name_short}} package.
* CLI version. Command line interface (CLI) version only. This does not modify the graphical desktop environment. This package provides better kernel hardening, improved entropy, and [[About#Hardening_by_Default|other security features]].
** For host operating systems: kicksecure-cli-host
** For Qubes users: kicksecure-qubes-cli
** For any other VMs (not Qubes): kicksecure-cli-vm
* GUI version. Similar to the CLI version but it installs the Xfce graphical desktop environment and default applications. This is useful if Debian was installed without a graphical desktop environment and the {{project_name_short}} graphical desktop environment (Xfce) is desired.
** For host operating systems: kicksecure-xfce-host
** For Qubes users: kicksecure-qubes-gui
** For any other VMs (not Qubes): kicksecure-xfce-vm
'''2.''' Install a {{project_name_short}} package such as kicksecure-cli-host
.
{{Install Package|package=
kicksecure-cli-host
}}
'''3.''' Troubleshooting. (Optional.)
Only in case of issues, see footnote. [
If apt returns an error about console-common when trying to install the Kicksecure package, install console-common first:
]sudo apt install console-common
Then try installing the Kicksecure package again. Meta package installation has been completed. Please proceed with the post-installation steps below.
Otherwise proceed to next step.
'''4.''' Next.
}}
== Post-Installation ==
{{Box|text=
'''1.''' Enable the /etc/apt/sources.list.d/derivative.list
{{project_name_short}} APT repository.
Can be done using the [[Project-APT-Repository|{{project_name_short}} repository tool]].
Two options. Choose one. Either using,
* '''A)''' CLI: {{CodeSelect|inline=true|code=
sudo repository-dist --enable --repository stable
}}, or
* '''B)''' GUI: Start Menu
→ System
→ Derivative Repository
→ choose either "stable", "stable-proposed-updates" , "Testers" or "Developers" repository
See the tool's wiki page for more detailed documentation if needed.
'''2.''' Disable the extrepo {{project_name_short_lowercase}}
APT repository.
This is to avoid a duplicate {{project_name_short}} repository.
{{CodeSelect|lang=bash|code=
sudo extrepo disable {{project_name_short_lowercase}}
}}
'''3.''' Check APT sources.
Check if some APT sources in /etc/apt/sources.list
should be kept.
Move the original /etc/apt/sources.list
file out of the way (or delete it) because it is replaced by {{project_name_short}}'s /etc/apt/sources.list.d/debian.list
.
{{CodeSelect|lang=bash|code=
sudo mv /etc/apt/sources.list ~/
}}
'''4.''' Create an empty /etc/apt/sources.list
file.
{{CodeSelect|lang=bash|code=
sudo touch /etc/apt/sources.list
}}
'''5.''' ''Optional:'' Set the onionized Debian repositories.
Follow [https://www.whonix.org/wiki/Onionizing_Repositories#Onionize_debian.list these instructions] if Debian's onion repositories are preferred.
'''6.''' Done.
The {{project_name_short}} installation is complete.
}}
= Footnotes =
{{reflist|close=1}}
{{Footer}}
[[Category:Documentation]]