Why is Doom Emacs so fast?

Doom aggressively lazy-loads packages, defers byte-compilation, caches autoloads, and patches upstream modules to avoid unnecessary startup work.

Does Doom Emacs work on Windows?

Yes, but the recommended Windows path is WSL or WSL2 for a real Linux userland.

Both offer modal editing and strong extensibility. Neovim is lighter and focused on Lua plugins; Doom Emacs brings the broader Emacs ecosystem, Org-mode, Magit, and declarative modules.

Doom Emacs vs Spacemacs (2025–2026)

Both are Emacs distributions with layered configs. Doom emphasizes faster startup, lazy loading, and a slimmer curated core.

Doom Emacs vs LazyVim

LazyVim targets the Neovim ecosystem. Doom Emacs targets GNU Emacs and brings the full Emacs package ecosystem, Org-mode workflow, and native Emacs extensions.

Doom Emacs vs vanilla Emacs

Vanilla Emacs has fewer defaults and a blank starting point. Doom Emacs adds a curated configuration layer, sensible defaults, and a CLI.

Zed is a standalone code editor. Doom Emacs is a framework for GNU Emacs that lets you keep the Emacs runtime and plugin model while layering on Doom’s performance optimizations and modules.

Doom Emacs vs Obsidian

Obsidian is notes-first, standalone software. Doom Emacs is a programmable Emacs environment for coding, note-taking, and productivity all inside one editor.

Doom Emacs vs GNU Emacs

Doom Emacs is not a fork. It is a structured config and CLI on top of stock GNU Emacs.

Troubleshooting: not loading, icons, deprecated package.cl, project directory

Verify stable Emacs, run doom doctor and doom sync. Install recommended fonts for icons, update packages for cl warnings, and open the repository root or add a project marker to fix directory detection.

Versions, evil off, and CLI commands

Use stable GNU Emacs 29.x or 30.x, disable the evil module in init.el to use stock keys, and use doom sync, doom upgrade, and quit with C-x C-c or :qa.

Should I consider adopting Doom Emacs as my editor?

Our documentation offers four detailed guides examining the merits of Emacs, its drawbacks, Doom-specific advantages, and potential limitations, plus comparisons with competing starter kits.

Is Doom based on an existing starter kit, or was it created independently?

Doom originated as an independent project in 2013, though it has since incorporated selected concepts from the wider Emacs community based on their practical value.

What distinguishes Doom as a framework rather than merely a starter kit?

A framework provides tools and organizational systems enabling users to create solutions effectively, whereas a starter kit delivers pre-built functionality. Doom combines both approaches.

Who is responsible for developing and maintaining Doom Emacs?

Henrik leads the project as primary maintainer, with plans to onboard co-maintainers once documentation and infrastructure meet specific criteria. Module maintainers are actively recruited.

What is the story behind Doom Emacs's distinctive name?

The name derives from childhood memories of the original Doom game, intertwined with humorous perspective on Emacs's legendary complexity.

What makes straight.el superior to the built-in package.el system?

Straight.el provides disaster recovery, version flexibility, access to diverse sources, and startup optimization that package.el cannot offer, making it essential for complex configurations.

Why does Doom emphasize startup speed, and should I use daemon mode?

Startup speed matters but shouldn't necessitate daemon mode; runtime performance is the priority. Doom supports daemons while advocating for architectural improvements.

How can I monitor Doom Emacs project development progress?

Consult our project manual for up-to-date links to development communication channels and resources.

Where should I direct bug reports, feature proposals, or seek technical assistance?

Submit issues through our official community channels, with Discourse recommended for thorough discussions.

How can I contribute questions or topics to this FAQ?

Engage with our community platforms; our team monitors discussions and selects commonly-asked questions for inclusion.

How do I determine which version of Doom Emacs is installed on my system?

Use M-x doom/info or doom info command to view detailed version information and system details.

How do I configure Doom Emacs as an IDE for a specific programming language?

Enable Doom's LSP module, activate the +lsp flag on your language module, install the appropriate language server, and run doom sync.

What methods exist for modifying fonts within Doom Emacs?

Doom provides multiple font variables supporting various specification formats. Modify, evaluate, and reload with M-x doom/reload-font for immediate results.

What options are available for applying and customizing color themes?

Set themes in your config file or switch interactively. See our theming guide for creating custom themes.

What is the correct process for updating Doom Emacs to newer versions?

Run doom upgrade and restart Emacs. Alternatively, use git pull and doom sync -u from ~/.emacs.d.

How do I define custom keyboard shortcuts or modify existing bindings?

Use Doom's map! macro for simplified binding syntax. See documentation with f map! for comprehensive examples.

How can I modify or customize the leader key configuration?

Refer to our manual for techniques on modifying leader keys and creating prefix bindings.

What options exist for adjusting or disabling line number display?

Configure display-line-numbers-type variable or cycle styles with M-x doom/toggle-line-numbers.

How do I deactivate Evil mode and its Vim keybindings?

Disable the evil module; see module documentation for removal procedures.

Under what circumstances should I execute the doom sync command?

Execute doom sync after module/init changes, package.el modifications, or system package installations.

How do I bypass confirmation dialogs when running Doom commands?

Use -! or --force flags with Doom commands to skip confirmation prompts.

How can I safely transfer my Doom configuration between different computers?

Sync your $DOOMDIR directory safely, but regenerate $EMACSDIR by running doom sync after transfer.

What should I do if Doom becomes severely misconfigured or problematic?

Delete ~/.emacs.d/.local/straight and run doom sync to reset completely.

How do I restore the traditional Vim behavior for the S key?

Disable evil-snipe-mode from doom-first-input-hook to restore traditional s and S key behavior.

Why is Doom Emacs running slowly or experiencing performance degradation?

See our Discourse community for current performance optimization guidance.

Why does Doom display a plain Emacs splash screen instead of loading properly?

Check for ~/.emacs file or run doom doctor to diagnose initialization problems.

Why does a scratch buffer appear at startup instead of the Doom dashboard?

Verify config location exists, check startup logs with C-h e, ensure dashboard module is enabled, or run doom doctor.

Why can't Doom locate executables or environment variables from my shell?

Verify shell PATH configuration, then run doom env to generate environment variables.

Why aren't my configuration changes being applied?

Ensure single config directory exists, run doom sync when needed, and defer package settings appropriately.

What causes Doom Emacs to crash or freeze unexpectedly?

Try alternative fonts, disable ligatures, or disable problematic UI modules on macOS.

Why do remote file connections through TRAMP hang indefinitely?

Consult the Emacs wiki for TRAMP-specific solutions.

Why does Doom highlight certain indentation with unattractive colors?

Fix indentation with tabify/untabify, configure indent-tabs-mode, use EditorConfig, or enable dtrt-indent.

What causes the "unsafe server directory" error on Windows systems?

Change ~/.emacs.d/server directory ownership to your Windows account via Properties.

Why don't my custom keyboard shortcuts function as expected?

Check conflicting mode keymaps with C-h k and unbind them before setting global bindings.

What triggers recursive load errors during startup?

Install GNU tar/gzip, verify PATH configuration, or use recommended Emacs builds.

⚡ v3.0 — Now Available

Doom Emacs — The Emacs Framework Built for Serious Hackers

Vim Bindings. Emacs Power. 3× Faster Than Vanilla.

Doom Emacs is a fast, modular configuration framework for GNU Emacs. Use the Install guide for macOS, Windows (including WSL), and Linux, then follow Getting Started for your first-day checklist. Comparisons and fixes live on the FAQ.

Install Doom Explore Features

50k+

Active Users

150+

Modules

0.4s

Avg Startup

4.8/5

Community Rating

WORKS WITH YOUR STACK

Python Rust TypeScript JavaScript Go Java Haskell Nix Clojure OCaml C/C++ Ruby Elixir

Core Philosophy

Built on Four Sacred Mantras

Every design decision in Doom flows from these principles.

Evil-style editing, Org, themes, language servers, and your private config can live in one workflow. Start with the Features overview, walk through Getting Started, then enable more from Modules (see languages). Editor comparisons sit on the FAQ so this page stays focused.

⚡

Gotta Go Fast

Startup and runtime performance are top priorities. Doom modifies packages to load lazily and run snappier — often 3× faster than vanilla Emacs.

🔩

Close to Metal

Less between you and vanilla Emacs by design. Internals are written as if reading them is part of Doom's UX — because it is.

🎛️

Opinionated, Not Stubborn

Reasonable defaults and curated opinions. Use as little or as much of Doom as you like — your config, your rules.

🌊

Reproducible by Design

Declarative package management powered by straight.el. Pin packages to any commit. Roll back releases. Nix/Guix support built-in.

Evil Mode

Vim Bindings.
Emacs Power.

Doom ships with world-class evil-mode integration — including ports of vim-sneak, vim-easymotion, vim-unimpaired, and dozens more beloved plugins. Switch between the best of both worlds without compromise. Compare editors on the FAQ, then deepen setup on Getting Started.

SPCLeader key — access everything

SPC h fDocumentation for any function

SPC p pSwitch projects instantly

SPC s pSearch project with ripgrep

SPC b bBuffer switcher

See All Features

init.el
packages.el
config.el
1;; Doom Emacs init.el
2
3(doom! :input
4      :completion
5      company  ; auto-completion
6      vertico ; fuzzy search
7      :editor
8      evil     ; vim emulation
9      snippets ; yasnippet
10     :lang
11     python  ; +lsp +pyright
12     rust    ; +lsp
13     web
 14     typescript 
15)
 NORMAL init.el 14:11 LSP ✓ 

150+ Modules

Everything You Need & More

Enable only what you need. Disable everything else. Zero bloat.

When you know your stack, jump to the right symbol on the modules page, or open Configuration for your private files.

🔍

Completion

Vertico, Company, Corfu, Helm, Ivy

📝

Editor

Evil, Snippets, Format, Parinfer

🎨

UI

Doom dashboard, Modeline, Tabs, Popups

🌐

Languages

40+ languages with LSP, treesitter, REPL

40+

🛠️

Tools

Docker, Terraform, Pass, Ansible, Magit

📖

Org

Org-mode, Roam, Journal, Babel, Reveal

Browse All 150+ Modules →

FAQ

Common Questions About Doom Emacs

Quick answers with links to the full FAQ, Install, and Getting Started guides.

What is Doom Emacs?

A configuration framework built on GNU Emacs that provides curated packages, keybindings, and sane defaults to make Emacs fast and usable out of the box.

What is Doom Emacs used for?

Code editing, writing, note-taking with org-mode, project management, and general power-user workflows. It’s highly extensible for almost any text-based task.

Is Doom Emacs good for beginners?

No. It has a steep learning curve and assumes Emacs familiarity. Beginners are better off starting with VS Code or Spacemacs first.

How to install Doom Emacs?

Doom Emacs requires GNU Emacs 28 or higher. First install Emacs on your system, then clone the Doom config folder, run the install command from your terminal, and finally add Doom to your system PATH. The full step-by-step walkthrough is available on the Install page of this site.

Is Doom Emacs worth it?

Yes — if you’re committed to Emacs. The speed, organised module system, and Vim keybindings make it one of the best Emacs setups available.

Browse all FAQ topics →

Blog

Latest Posts

Guides, tips, and updates — straight to the point.

Guide

Getting Started with Doom Emacs

Tips

Top 10 Modules You Should Enable

Update

What’s New in V3.0

Ready to Enter the Doom?

Set up fast, stay modular, and tailor everything to your workflow.

Full Install Guide Getting Started