Quick Start

Install in Minutes

One command is all it takes to join the dark side. Full setup guide below.

Covers doom emacs install macos, doom emacs install windows (WSL/WSL2), doom emacs ubuntu, doom emacs fedora, doom emacs arch linux, doom emacs nixos, and doom emacs homebrew. After installing, head to the getting started guide, browse 150+ modules, or check the FAQ.

1. Prerequisites 2. Install 3. Configure 4. Sync & Launch 5. Next Steps
01

Prerequisites

Doom requires a few tools before installation. Install them with your package manager.

# Install Homebrew first if you use it for dependencies
$ brew install git ripgrep fd emacs
# Optional but recommended:
$ brew install coreutils fd
Required
GNU Emacs 29.1+ — 30.2 recommended
Required
Git ≥ 2.23
Required
ripgrep ≥ 11.0
Recommended
fd 7.3.0+ — faster file indexing
⚠️ Avoid pre-release Emacs builds (versions ending in .50, .60, .9X). Always use a stable release.
02

Clone & Install

Run these two commands. That's it. Doom will handle the rest.

# Clone Doom into ~/.config/emacs
$ git clone --depth 1 <official-doom-emacs-repo> ~/.config/emacs
 
# Run the installer
$ ~/.config/emacs/bin/doom install
💡 Pro tip: Add ~/.config/emacs/bin to your PATH for easy access to doom commands anywhere.
03

Configure Your Doom

Your private config lives in ~/.doom.d/. Edit these three files:

init.elCore

Enable/disable modules. This is your module selection file — the heart of Doom.

packages.elPackages

Declare additional packages to install. Use (package! name) syntax.

config.elCustom

Your personal configuration. Keybindings, themes, hooks, functions — all here.

04

Sync & Launch

After editing your config, sync to apply changes, then launch Emacs.

$ doom sync
# Installs missing packages, removes orphans
 
$ emacs
# ✓ Welcome to Doom. 🔥