Skip to content

From GUI application

You can install Krux (both official or beta releases) onto your K210-based device using our official desktop application, KruxInstaller, available for Linux and Windows.

Download

Download the installer by choosing the right asset for your operating system from our Github releases page:

Operational System File
Windows krux-installer_0.0.13.exe*
Debian-based: Ubuntu, PopOS, etc... krux-installer_0.0.13_amd64.deb*
RedHat-based: Fedora, etc... krux-installer-0.0.13.x86_64.rpm*
Any linux distribution krux-installer-0.0.13.AppImage*
Package for Archlinux on AUR. krux-installer-bin

Verify files

If you trust the project developers, you can skip to install:

⚠️ TIP: This step helps detect if any unauthorized modifications were made between github and your local computer.

Integrity

System Commands
Windows (powershell) 
# Compare this output:
(Get-FileHash 'krux-installer_0.0.13.exe').Hash

# With this:
Get-Content 'krux-installer_0.0.13.exe.sha256.txt'
Debian-based 
sha256sum --check ./krux-installer_0.0.13_amd64.deb.sha256.txt
RedHat-based 
sha256txt --check ./krux-installer-0.0.13.x86_64.rpm.sha256.txt
Any Linux distribution 
sha256sum --check ./krux-installer-0.0.13.AppImage.sha256.txt

Authenticity

You will need have GPG installed. Most Linux already have this, but on Windows we recommend installing GPG4Win.

Once installed, run this command to retrieve the developer's key:

gpg --keyserver hkps://keys.openpgp.org --recv-keys B4281DDDFBBD207BFA4113138974C90299326322

Then you can verify:

System Command
Windows (powershell) gpg --verify krux-installer_0.0.13.exe.sig
Debian-based gpg --verify ./krux-installer_0.0.13_amd64.deb.sig
RedHat-based gpg --verify ./krux-installer-0.0.13.x86_64.rpm.sig
Any Linux distribution gpg --verify ./krux-installer-0.0.13.AppImage.sig

⚠️ TIP: If the verification was successful, you may get a message similar to: Good signature from "qlrddev <qlrddev@gmail.com>"

Install

Each system require different steps to install:

System Steps
Windows
  • The krux-installer_0.0.13.exe is a NSIS installer;
  • The first time you run the .exe file the system will ask you to trust the application;
  • See windows section below for more information
Debian-based
  • Install with dpkg: sudo dpkg -i krux-installer_0.0.13_amd64.deb;
  • Update it with apt-get: sudo apt-get install -f krux-installer_0.0.13_amd64.deb.
RedHat-based
  • Fedora: sudo dnf install krux-installer-0.0.13.x86_64.rpm;
  • Other RedHat based distros: sudo yum localinstall krux-installer-0.0.13.x86_64.rpm.
Any Linux distribution
  • Place the krux-installer-0.0.13.AppImage where you want;
  • Modify permision to execute: chmod +x krux-installer-0.0.13.AppImage;
  • Run it: ./krux-installer-0.0.13.AppImage.

Windows

On Windows, you'll be faced with a blue window saying "Windows protected your PC". This occurs because we don't have a code signing certificate, Click on "More info" and allow the execution. Follow the installer's instructions to complete the installation.

🛡️ TIP: If you followed the steps presented in authenticity, you already have the assurance that the software is from a verified and genuine software publisher

Windows protected your computer

Usage

When executing the Krux Installer, you will be presented with a menu of two items:

KruxInstaller Main Menu

Select Device

First, select the device we want to flash. After that the menu will shown three items:

Select Device Menu with choosen device

Menu with three items

Select Version

This option allows you to select the latest official version or the latest beta version on our github. If the connection works, you will see the following screen:

Select version menu

Version Name Advantages Disadvantages
Official selfcustody/krux/releases/tag/*
  • Stable version;
  • All features were reviewd and tested;
  • It's integrity and authenticity can be verified.
  • Updates may take some time to be released.
Beta odudex/krux_binaries
  • Latest features available;
  • Constant UX reviews by our community.
  • Its integrity or authenticity cannot be verified.

Flash

Once you choose the device and version, it enables the "flash with ktool" button.

⚠️ TIP: You must connect and turn on your device before flashing. In Linux, you'll be prompted to type your password (sudo or admin). Do not disconnect the device until the process is complete!

Main menu with flash button

When the flashing process completes, you should see the Krux logo:

If it doesn't, try turning your device off and on by holding down the power button for six seconds.

Congrats, you're now running Krux!

Wipe device

This option erases ALL data from the device's flash memory. On Linux, it will prompt for your password before. Once the process starts, the screen will appear frozen. When it's done, you can scroll down and see all the events that occurred.

⚠️ TIP: It's useful when your device is not working or for security reasons. To use Krux again, you'll need to re-flash the firmware.

Wipe Warning

⚠️ TIP: Do not unplug or poweroff your device or computer. Wait until the process finishes.

Multilingual support

Prefer a different language? Krux has support for multiple languages. Once at the start screen, go to Settings, followed by Locale, and select the locale you wish to use.

Upgrade via microSD card

Once you've installed the initial firmware on your device via USB, you can either continue updating the device by flashing or you can perform upgrades via microSD card to keep the device airgapped.