Installation

Detailed guide for installing Ghostty Configuration Files

System Requirements

Ubuntu 22.04+ or Debian-based distribution required

Component	Minimum	Recommended
OS	Ubuntu 22.04	Ubuntu 24.04+
RAM	2 GB	4 GB+
Disk Space	500 MB	1 GB+
Network	Required	Broadband

Step-by-Step Installation

1. Install Prerequisites

Ensure you have git and curl installed:

sudo apt update && sudo apt install -y git curl

2. Clone the Repository

git clone https://github.com/kairin/ghostty-config-files

cd ghostty-config-files

3. Run the Installer

./start.sh

4. Follow the Interactive Menu

The installer provides a modern Go-based TUI dashboard to manage your tools:

╭───────────────────────────────────────────────────────────────────────────╮

│ System Installer │

├───────────────────────────────────────────────────────────────────────────┤

│ APP STATUS VERSION LATEST METHOD │

│ ─────────────────────────────────────────────────────────────────────── │

│ Feh ✓ OK 0.28.1 - APT │

│ Ghostty ✓ OK 1.2.3+tip v1.2.3 Source │

│ Nerd Fonts ↑ Update 3.3.0 v3.4.0 GitHub │

│ Node.js ✓ OK v22.16.0 v22.16.0 fnm │

│ Local AI Tools ✓ OK detected - npm │

╰───────────────────────────────────────────────────────────────────────────╯

Choose:

▸ Feh

Ghostty

Nerd Fonts

Node.js

Local AI Tools

Extras →

Boot Diagnostics

5. View Tool Documentation

Each tool has a "Show Details" option that displays comprehensive documentation:

╭─────── Summary: ghostty ───────╮

│ │

# Ghostty Terminal

GPU-accelerated terminal emulator...

│ │

╰────────────────────────────────╯

↳ View Full Details uses pager:

q=exit ↑↓=scroll /=search

What would you like to do?

▸ View Full Details

Return to Menu

Pager Controls

When viewing full details: q exits, ↑↓ scrolls, / searches.

Post-Installation

Restart Your Shell

After installation, either:

Close and reopen your terminal, or
Run: source ~/.zshrc

Verify Installation

Check that everything installed correctly:

ghostty --version

1.2.3

echo $SHELL

/usr/bin/zsh

Uninstallation

To remove installed components:

./start.sh

# Select an app and choose "Uninstall"

Manual Installation

If you prefer to install components individually, each has its own script:

Install just Ghostty

./scripts/004-reinstall/install_ghostty.sh

Install just Nerd Fonts

./scripts/004-reinstall/install_nerdfonts.sh