Skip to content

Installation

Jump to bottom
Dan K edited this page May 7, 2024 · 1 revision

First of all you need to install Debian.

Currently this build is tested on Debian 12 Bookworm. It's recommended to use Debian 12 to avoid problem caused by missing or renamed packages in apt repos.

Creating bootable USB

You can download ISO from Debian official site. Usually it's much easier to use netinst ISO because it's way smaller than full DVD ISO with packages included. Netinst requires network connection to run the installer but TilingOS itself currently doesn't support offline installation, so there's no need to use Debian offline installer.

If you're already a Linux user, you can easily write Debian ISO with this command: dd if="<path to iso>" of="<device name>" status="progress" conv="fsync" To find your USB stick you can use lsblk or fdisk -l

If you're currently running another OS use GUI tools such as Balena Etcher.

Installing Debian

Boot from USB drive, proceed interactive installation. There're some recommended options:

  • Location - note that this option can cause problems with formats localization like print paper size or date format if you select random country.
  • Root password - leave blank if you don't need root login - sudo will be automatically configured
  • Disk partitioning - that's a lot of options here so if you're a beginner in linux it's recommended to use guided partitioning with option "Separate /home partition". If you want to do it manually there's little cheatsheet:
    • EFI partition if you're running UEFI PC
    • Swap - RAM size + 2GB
    • Separate home partition
    • Separate data partition
  • Archive mirror - it's strongly recommended to use you real country because selecting mirror in another country will cause long ping that will dramatically decrease small packages download speed

  • Debian desktop environment must not be installed!

Installing TilingOS

First you need to login from root: use directly root login&password if you've configured it previously or login from your normal account and type

sudo -i

Install git - it is used to clone this repo:

apt update && apt upgrade && apt install git

Clone the repo itself:

git clone https://github.com/qmaster0803/tilingDistro

Go to repo directory:

cd tilingDistro

Run the installer:

python3 main.py

Follow interactive installer.

Welcome to the open source software

Clone this wiki locally