Booting into lockdown/admin builds

!!WARNING!! - THESE BUILDS ARE MEANT TO REPLACE YOUR EXISTING OPERATING SYSTEM OR BE INSTALLED ON NEW HARDWARE. THESE ARE NOT INTENDED FOR DUAL-BOOTING

!!Notice!!: These builds come with A/B OTA Update support, and will not work in Live mode, and will not install properly if using anything except the Bootable USB install method we include in the .iso.

Bootable USB Install

We will need to use the bootable USB install method. Similar to this guide: https://docs.blisscolabs.dev/installation/x86_64-v2/install-from-bootable-usb/

Install Steps:

1) We will want to start by booting into the installer by selecting the top Install option

2) From here we will want to change the drive partition scheme to be A) EFI (VFAT) B) Android (ext4). This means that we need to delete all partitions except for the top EFI partition, and create a single new partition with the remaining space. Select Write when complete, then Quit. The end result should look like the image below.

3) We can now select the 2nd partition (ext4) to install the OS on. Once selected, it will prompt to select a filesystem type. Select EXT4 and confirm that we do want to reformat

4) It will then reformat the drive, then it will ask if we want to install Grub EFI. Select Yes.

5) If you have a previous install, you will also get a prompt asking if you want to replace the Grub EFI boot entry. Select Yes as well.

6) The installer will/ then write the system to the drive, and afterwards, it will setup the install for A/B updates

7) Once that is complete, the installer will give you a choice to Run or Reboot. We want to select Reboot here, making sure to remove the USB drive after the device reboots.

Booting into the OS

Also covered in this guide: https://docs.blisscolabs.dev/setup_and_configuration/booting-into-lockdown-builds/

(!!NOTICE FOR BUILDS THAT HIDE GRUB!!) When the device reboots, it will not show the grub menu by default, and automatically boot into the last known boot mode. In order to show the grub menu, tap shift multiple times while the initial BIOS boot logo is displayed. If done correctly, you will be presented with the Grub menu. If no keys are pressed, the bios boot menu will show a black screen afterwards while Grub is loading the configuration in the background.

Once the device boots into Grub, the top option or two will be our locked down mode (Default, Intel Default or AMD Default)

While the Admin modes can be found in the Other Options section of the boot menu.

(!!PLEASE NOTE!!): Only Admin mode will have access to the Android notification stack, navigation options, status bar, etc. In some builds, lockdown mode removes all these functions at the system level for redundancy and added security.

The options used to configure those restrictions can be overridden with the following options:

• Navigation: Disables the system navigation gestures options: true, false

  FORCE_DISABLE_NAVIGATION=*

• Navigation Gesture Handle: Disables the gestural navigation handle options: true, false

  FORCE_DISABLE_NAV_HANDLE=*

• Navigation Taskbar (only on large-screen devices): Disables SystemUI Taskbar (not Launcher3) options: true, false

  FORCE_DISABLE_NAV_TASKBAR=*

• Statusbar: Disabled the statusbar at the top of the screen (does not disable Launcher3s gesture to show notification drawer) options: true, false

  FORCE_DISABLE_STATUSBAR=*

Setting Up Bliss Kiosk Launcher

If your BlissBass builds comes with Bliss Kiosk Launcher, then you have the ability to restrict it’s access to various packages on the device, as well as set specific packages to auto-launch when booting the device into Lockdown mode (Intel Default), or locking the device while in Admin mode (Other Options > Intel - Admin).

Lockdown Mode:

In Lockdown mode, navigation bar, gesture handle and status bar are all disabled. The app drawer will only display allowed packages.

While in Lockdown mode, you can access the Kiosk Launcher Settings by clicking the Exit button, and inputting the maintenance password set (default is: 123):

Admin Mode

This mode shows a sprocket next to the exit icon, and depending on boot mode, will also display the navigation handle and statusbar, along with the app drawer containing all packages

Configuration

Clicking on the sprocket from the home screen will launch the Kiosk Launcher Settings screen.From the settings screen, you can manage the Maintenance Password, Change whitelisted apps, and set which package you want to Auto Launch when Kiosk Launcher starts in Lockdown mode. You can also test the Kiosk Launcher while within Admin mode to ensure functionality before rebooting to Lockdown mode.