User Documentation

Dual Boot Installation

Safely install Cabina OS alongside Windows. Comprehensive guide covering disk shrinking, partition sharing, and GRUB OS Prober setup.

01. Disk Prep

Pre-installation (Windows Shrink Volume)

Before proceeding with a dual boot installation, you must prepare unallocated space on your Windows disk.

  • Open Disk Management in your Windows OS.
  • Right-click on the main partition (e.g., Disk C:) and select Shrink Volume.
  • Determine the size to allocate for Cabina OS (recommended at least 30GB or 30000 MB).
  • Click Shrink, and ensure black Unallocated Space appears in your disk table.
CAUTION: BACKUP DATA

Partition modification carries risks. It is highly recommended to back up your important data on Windows before performing a Shrink Volume.

cfdisk partition utility

02. BIOS / UEFI

Boot Menu & Secure Boot

Once the disk space is prepared, plug in your Cabina OS bootable USB.

  • Disable Secure Boot: Access your laptop/PC's BIOS/UEFI firmware settings. Find the Secure Boot setting and change it to Disabled. Cabina OS requires Secure Boot to be off to load kernel modules.
  • Cabina OS Desktop Environment
  • Boot Priority: Move the Cabina OS Bootable USB to the top of the Boot Priority list. Save changes and Exit.
  • Cabina OS Desktop Environment
  • The laptop will reboot and display the Cabina OS GRUB menu. Select the top option to enter the Live Environment.
  • Cabina OS Desktop Environment

03. Networking

Network Connection

Use iwctl in the Live Environment terminal to connect to Wi-Fi, as the installer requires an internet connection to download additional dependency packages.

Cabina OS Desktop Environment
station wlan0 scan
station wlan0 get-networks
station wlan0 connect 'nama-wifi'

04. Shared Storage

Disk Partitioning

Open the partition utility with cfdisk /dev/[disk] (e.g., cfdisk /dev/nvme0n1).

Cabina OS Desktop Environment

VERY IMPORTANT: Do not delete or modify existing Windows (NTFS) partitions! Find the Free Space you created earlier (Shrink), then create the Linux partitions there.

  • EFI Partition: Use the existing Windows EFI partition (usually 100MB - 300MB, type EFI System). Do not format this partition, just mount it later.
  • Create a Root partition (Linux filesystem) in the Free Space.
  • Create a Home partition in the remaining Free Space.
  • Create a Swap partition if necessary.

05. Deployment

Installation Process

Once disk partitioning is finalized, you are ready to acquire and run the automated Cabina OS installation script. Execute the following terminal commands in order:

Launch the installer routine directly from the terminal:
bash
cabina-install

06. Interactive Configuration

Step by Step

While executing cabina-install, the interactive script will guide you through system provisioning. Follow these chronological milestones during setup:

Cabina OS Desktop Environment
1

Specify partition for boot (EFI)

Example: /dev/sda1
2

Specify partition for filesystem root

Example: /dev/sda2
3

Specify partition for home directory

Example: /dev/sda3
4

Specify partition for system swap

Example: /dev/sda4
Cabina OS Desktop Environment
5

Enter account username

Example: user
6

Enter network hostname

Example: cabinahost
7

Assign account password

Example: YourUserPassword1000
8

Select numerical region index for your timezone

Example: 1 for Asia
9

Enter target country/city for your timezone

Example: Jakarta
10

Select system keyboard layout and language

Example: 2 for US
Cabina OS Desktop Environment
11

Review assigned parameter profile

Carefully verify your partition mappings, user credentials, hostname, and localization preferences before committing installation changes.

Type 'yes' to commence automated deployment

Confirmation: yes
Cabina OS Desktop Environment
The system will automatically install base packages and configure your system environment. Upon finish, reboot your device to launch into your newly deployed Cabina OS desktop.
Cabina OS Desktop Environment

07. Post-install

After Installation

Once your device has rebooted, the Plasma login screen will appear and you can log in by entering the password you created during installation.

LOGIN SCREEN

Welcome to Cabina OS! Enter your user password to access the desktop environment.

Cabina OS Desktop Environment

08. App Setup

Omeka Setup

After logging into Cabina OS, you can directly access the Omeka application to manage archives via the Mozilla Firefox browser, which is available by default in Cabina OS.

Cabina OS Desktop Environment
  • Step 1: Select the Omeka bookmark in the Firefox browser that is available by default.
  • Cabina OS Desktop Environment
  • Step 2: You will be prompted to create an account and configure site settings such as entering a username, password, email, etc., before installing Omeka.
  • Cabina OS Desktop Environment
  • Step 3: After creating an account and configuring site settings, click install. Upon success, you can choose to open the public site for general access or the admin dashboard to manage archives.
  • Cabina OS Desktop Environment