Documentation

Complete guides for installing, configuring, and maintaining Darby Linux across all supported platforms.

Quick Start

Get up and running in under 5 minutes

Install base Linux

Ubuntu 22.04 LTS minimal on your target machine

Run one command

curl -fsSL https://darbylinux.com/install | sudo bash

Reboot

Enjoy your fully configured Darby Linux desktop

Installation Guides

Intel Mac Installation

2008–2019

Back up your data

Use Time Machine or copy files to external storage.

Check your Mac model

Apple menu → About This Mac → Note the Model Identifier.

Create bootable USB

Download Ubuntu 22.04 LTS and flash with balenaEtcher.

Boot from USB

Shut down, insert USB, power on holding Option (⌥) key.

Install base Linux

Follow Ubuntu installer, choose Minimal Installation.

Run Darby Linux installer

curl -fsSL https://darbylinux.com/install | sudo bash

Reboot and enjoy

Your Mac is now running a fully optimized Linux desktop.

Configuration Guides

Gaming Setup

Steam, Proton, Wine, Lutris, and GPU optimization

Install gaming stack

sudo ./install.sh --enable-gaming

Launch with GameMode

gamemoderun steam

Performance mode

sudo ./scripts/gaming/setup_gaming.sh --performance-on

Office Suite

LibreOffice, OnlyOffice, WPS Office installation

Install office suite

sudo ./install.sh --enable-office

Install LibreOffice

sudo apt install libreoffice

Security Hardening

Firewall, AppArmor, Fail2ban, SSH configuration

Check security status

sudo ./scripts/security/harden.sh --status

Run security audit

sudo ./scripts/security/harden.sh --audit

Firewall status

sudo ufw status

Language Setup

Multi-language configuration and input methods

List available locales

locale -a

Generate locale

sudo locale-gen en_US.UTF-8

Set default

sudo update-locale LANG=en_US.UTF-8

Update Management

OTA updates, rollback, and version control

Check for updates

sudo /opt/darby-linux/scripts/ota/update_manager_v2.sh check

Install updates

sudo /opt/darby-linux/scripts/ota/update_manager_v2.sh install

Rollback update

sudo /opt/darby-linux/scripts/ota/update_manager_v2.sh rollback

Desktop Customization

Wallpaper, DPI scaling, keyboard, and trackpad

Set wallpaper

./scripts/ui/wallpaper_manager.sh --set /path/to/image.png

Generate wallpaper

sudo ./scripts/ui/wallpaper_manager.sh --generate

Adjust DPI

xfconf-query -c xsettings -p /Xft/DPI -s 144

Essential Keyboard Shortcuts

SuperOpen application menu

Ctrl+Alt+TOpen terminal

Alt+F2Run dialog

Ctrl+Alt+DShow desktop

Alt+TabSwitch windows

Super+LLock screen