Release Upgrade Kicksecure 16 to Kicksecure 17

Kicksecure ™

Download

On Computer USB Installation Debian morph to Kicksecure Windows (VM) Linux (VM) Mac (VM) VirtualBox (VM) KVM (VM) Qubes (VM) More options Source Code

About

Overview Features Why Open Source? Project Activities Contributors Mission & Vision

Docs

Documentation FAQ Troubleshooting

Community

Forums Contribute

Support

Self Support First Policy Search Engines, Docs and AI Support (Limited) Reporting Bugs Contact (Restricted)

Tools Upload file Special pages Recent changes Print Version Page meta What links here Related changes Page information

Page Read Edit History Move Protection Unwatch Watch Delete Purge

User Preferences Watchlist Contributions Logout Create account Login

Donate

How to Release Upgrade from Kicksecure 16 to Kicksecure 17

Notices

Table: Release Upgrade Kicksecure Notices

Notice	Description
Difficulty	Downloading a new Kicksecure / Kicksecure (Factory Reset) is easier than applying the Release Upgrade instructions on this page. Debian release notes: Chapter 4. Upgrades from Debian 11 (bullseye) Chapter 5. Issues to be aware of for bookworm
Release Upgrade vs Re-Installation	To use Kicksecure 17, users can either: A) Release upgrade existing Kicksecure 16 images using the instructions on this page; OR B) Factory Reset using the Kicksecure re-install method by downloading the new release, which is much simpler than upgrading: Kicksecure 17: download the new release. Kicksecure for Qubes 17: download the new release.
Standard Updates	For standard ("everyday") update instructions see Operating System Software and Updates. The instructions on this page describe how to perform a Release Upgrade from Kicksecure 16 to Kicksecure 17.
Automated Release Upgrade vs Manual Release Upgrade	Automated Release Upgrade is the newer method that has been implemented. It does not ask for user input and is therefore easier to use. The former Manual Release Upgrade effectively did the same, but it offered more control over system customization. It is now deprecated.
Configuration Files Resets	Since this is an automated release upgrade, user modified configuration files (if any) in folder /etc will be reset, overwritten with the Debian or Kicksecure package version. The user is free to restore the configuration after the release upgrade.

High Level Overview

1. Backup all data - ideally have a copy of the VM(s) so it is possible to try again (if necessary).
2. Perform the usual standard ("everyday") update instructions.
3. Consider running the optional sanity tests.
4. Release Upgrade Kicksecure
5. Power off Kicksecure
6. Release Upgrade Kicksecure
7. Restart Kicksecure

Sanity Tests

These are optional, but recommended. To complete sanity tests, please press on expand on the right.

sudo dpkg --audit ; echo $?

Expected output.

sudo dpkg --configure -a ; echo $?

Expected output.

Get package upgrades.

sudo apt update

sudo apt full-upgrade

For testing purposes, install package nano.

sudo apt install nano ; echo $?

## ... successful installation of nano ... 0

Apt install fix missing.

sudo apt install -f

Expected upgrade.

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
0 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.

Release Upgrade

1. Backup all data - ideally have a clone of the VM(s) so it is possible to try again (if necessary).
2. Perform the usual standard ("everyday") update instructions.
3. Consider running the optional sanity tests.
4. Run systemcheck.
5. View release-upgrade command version. cat /usr/sbin/release-upgrade | grep version=
6. Check release-upgrade command version. Should be minimum 2.0, should show version="2.0".
7. Consider keeping the full release upgrade log output. It will be required for Support in case there are issues.
8. Perform the automated release upgrade using release-upgrade command. sudo release-upgrade
9. Done. If everything went well, at the end it will show:

   INFO: OK. (release-upgrade version: 2.0) Release upgrade success.

10. Reboot.
11. Optional, recommended: Re-install Meta Packages and Safely Run Autoremove

Footnotes

Kicksecure A secure by default operating system with the latest security research in place.

Dark mode

Follow us on social media

Supported by Power Up Privacy

Kicksecure is proudly supported until 2025 by Power Up Privacy, a privacy advocacy group that seeks to supercharge privacy projects with resources so they can complete their mission of making our world a better place. (Strictly subject to our sponsorship policy.)

At Kicksecure we value freedom and trust, supporting Open Source and Freedom Software

By using this website, you acknowledge you have read, understood, and agree to be bound by these agreements: Terms of Service, Privacy Policy, Cookie Policy, E-Sign Consent, DMCA, Imprint 2012- 2024 ENCRYPTED SUPPORT LP

Your support makes
all the difference!

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!