Documentation.

1. Installation Requirements

Before you begin, make sure your device meets the following minimum requirements:

• Firmware: UEFI — required because the installation uses a GPT partition scheme with an EFI System partition.
• Installer Media: Shelver OS ISO file.
• Storage Capacity: At least 30 GB of free disk space.
• Network Connection: A stable internet connection.
• Data Backup: All important data has already been backed up elsewhere.
• Device Architecture: A 64-bit processor.

2. Installation Steps

Step 1: Boot into the Shelver OS Live Environment

1. Plug the installer media (flash drive) into the computer, then restart it.
2. As soon as the first screen appears, enter the Boot Menu (usually via F12, F11, F8, F9, or Delete, depending on the device manufacturer).
3. Select the Shelver OS installer media from the boot list.
4. Wait for the system to load the installer environment. You will be logged in automatically as root, with no password required.

Step 2: Check Available Disks

Before creating partitions, first identify the available disks on the system:

Important Warning: Make sure you select the correct disk name (e.g. /dev/sda). Selecting the wrong disk can result in data loss on other drives.

2.1 Network Setup

Before installation can proceed, your device needs to be connected to the Internet. This connection is used to download git and the packages required by SLiMS (Apache, PHP, MariaDB), so make sure it's active before moving to the next step.

If you're using Wi-Fi, connect through the command line using the built-in iwctl utility by following these steps:

1. Open the iwctl prompt:
   iwctl
2. Scan for available Wi-Fi networks:
   station wlan0 scan
3. Show the list of networks found:
   station wlan0 get-networks
4. Connect to your network by entering its name:
   station wlan0 connect "wifi_name"

Note: wlan0 is the most common Wi-Fi interface name, but it can vary by device. If the command doesn't work, run device list inside the iwctl prompt first to check the correct interface name on your machine.

If you're using a wired (Ethernet) connection, no extra setup is usually needed ust make sure the cable is plugged in.

2.2 Creating Partitions with cfdisk

Create partitions according to the planned scheme, using these steps:

1. Move to the free space, select New, and enter the desired partition size.
2. Once the partition is created, select Type to set its partition type (e.g. EFI System for the first partition).
3. Repeat the steps above until all planned partitions have been created.

2.3 Partition Scheme

Before installation, the disk needs to be divided into several partitions using the GPT (GUID Partition Table) scheme. GPT is used for the following reasons:

• GPT is required for systems that boot via UEFI, since an EFI System partition can only be created on top of this scheme.
• GPT supports large-capacity disks and allows more than four primary partitions, unlike the older MBR/dos scheme, which is more limited.

Recommended Partition Scheme (Example: 30 GB Disk):

Adjust each partition's size to match your disk capacity and needs.

Partition Structure Visualization (30 GB Disk):

Disk 30GB (/dev/sda)
├── EFI      2 GB
├── Root    18 GB
├── Home     8 GB
└── Swap     2 GB

2.4 Saving and Exiting cfdisk

1. Select Write at the bottom of the screen to save the partition configuration you've created.
2. Type yes, then press Enter to confirm the changes to the disk.
3. Select Quit to exit the cfdisk utility.

Step 3: Running the Installer

Run the automated installation script to begin:

The installer will display the Shelver OS INSTALLER banner, then guide you through several configuration stages in sequence, as described below.

3.1 Displaying the Partition List

The installer automatically displays the list of partitions available on the disk (equivalent to lsblk output) as a reference before you specify the target partitions:

[INFO] Displaying available disk partitions...

NAME    FSTYPE    SIZE  MOUNTPOINTS
loop0   squashfs  999.4M /run/archiso/airootfs
sr0     iso9660   1.5G   /run/archiso/bootmnt
sda               30G
├─sda1             2G
├─sda2            18G
├─sda3             8G
└─sda4             2G

3.2 Specifying Target Partitions

The installer will ask you to enter the device for each target partition based on its role. Pay close attention here, since each partition will be automatically formatted according to the filesystem the installer specifies:

[INFO] Please enter the target partitions: (e.g: /dev/sda1 or /dev/nvme0n1p1):
  1. Boot/EFI Partition Shelver OS (Will be formatted FAT32): /dev/sda1
  2. Root Partition Shelver OS (Will be formatted EXT4): /dev/sda2
  3. Home Partition Shelver OS (Will be formatted EXT4): /dev/sda3
  4. Swap Partition Shelver OS (Will be formatted SWAP) : /dev/sda4

Enter the devices according to the partitions created in Step 2:

Important Warning: Make sure the devices you enter match the order and size of the partitions created in Step 2. Entering the wrong device — for example, swapping /dev/sda2 with /dev/sda3 — will cause the partition to be formatted with the wrong filesystem, and risks erasing data on the wrong partition.

3.3 User Identity and Password Configuration

Once the target partitions are confirmed, the installer will ask you to enter the user identity and password:

Security Note: Since this password applies to both the regular user and root, use a strong, unique password. Avoid using example or default passwords in a real installation.

3.4 Region Configuration

Next, the installer will ask for regional settings to determine the system's timezone:

This information is used by the installer to automatically set the system timezone (e.g. Asia/Jakarta) based on the user's location.

3.5 Confirming the Installation Summary

Once all configuration is complete, the installer will display a full summary of the settings you've entered, along with a final warning before the partition data is actually erased and formatted.

Review the following summary carefully before proceeding:

This is the final confirmation point. Once you type yes and press Enter, all listed partitions will be formatted immediately, and all data on them will be permanently lost. Make sure the devices and configuration above are correct before proceeding.

Type yes, then press Enter to continue the installation.

3. SLiMS Installation

Once system configuration is complete, the process continues to the installation of SLiMS (Sistem Informasi Manajemen Perpustakaan / Library Management Information System).

Once all input has been provided, the installer will download and install the required packages.

Note: This process requires an active internet connection, as all packages are downloaded directly from the repository.

4. Rebooting the System

Once the SLiMS installation process completes, the installer will display a final success message confirming that Shelver OS has been installed successfully.

Run the reboot command:

Once the SLiMS installation completes successfully, restart your computer. Shelver OS, along with SLiMS, is now ready to use.