Ghostty Docs
Home

Getting Started

Get up and running with Ghostty Config Files in under 2 minutes

Prerequisites

  • Ubuntu 22.04+ or compatible Debian-based distribution
  • Git installed (sudo apt install git)
  • sudo access for installing packages

Quick Install

Clone the repository and run the installer:

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

What Happens Next?

The interactive installer will guide you through:

System Check

Verifies prerequisites

Select Apps

Choose what to install

Install

Automated setup

Configure

Apply settings

First Run

After installation completes:

  1. Restart your terminal or run source ~/.zshrc
  2. Open Ghostty from your application menu or run ghostty
  3. Enjoy! Your new terminal environment is ready

Tip: Right-click menu

If you installed the context menu integration, you can right-click any folder to "Open in Ghostty"!

Tip: Show Details

Select any tool and choose "Show Details" to view documentation with install instructions, features, and troubleshooting tips!

Troubleshooting

If you encounter issues:

  • Permission denied: Make sure you have sudo access
  • Network errors: Check your internet connection
  • ZSH not default: Run chsh -s $(which zsh)

For more help, check the GitHub Issues page.