Skip to content
@doomemacs

Doom Emacs

A configuration framework for GNU Emacs.

Discord Server Discussions board Support the project

It's a tale as old as time: a stubborn, shell-dwelling, and melodramatic vimmer -- tormented by Vimscript and his boundless productivity -- makes a formal request to the netherworld for a transfer. They agree. The terms? He must lure more unsuspecting souls into a life of eternal bikeshedding. Now he runs the place.

Doom Emacs is an Emacs Lisp development tool and configuration framework for GNU Emacs, tailored for Emacs enthusiasts that want a faster, more reliable, and reproducible foundation for their next config or elisp project, or for beginners who want a softer introduction to our favorite operating system.

Quick start

git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.config/emacs
~/.config/emacs/bin/doom install

This is the quickest way to get a Doom environment up and running. Visit our getting started guide for more in-depth instructions.

Prerequisites

  • Emacs 27.1–30.1 (30.1 is recommended)
  • Git 2.23+
  • Ripgrep 11.0+

Warning

Doom core supports 27.1, but Doom's modules requires 28.1 at minimum. Some modules (particularly tree-sitter) require 29.1 or newer. Other module requirements may apply, so don't forget to run $ doom doctor after installing Doom!

Project resources

Frequently asked questions

Social media

❤️ Support the project

Doom and its community are labors of love and the incurable madness of its maintainer and volunteers. Doom wouldn't be where it is today without your help. Help us keep the lights on by:

Pinned Loading

  1. doomemacs Public

    An Emacs framework for the stubborn martian hacker

    Emacs Lisp 20.6k 3.1k

  2. themes Public

    A megapack of themes for GNU Emacs.

    Emacs Lisp 2.3k 405

  3. modules Public

    Official modules for Doom Emacs

    Emacs Lisp 11 1

  4. modules-contrib Public

    Community-contributed modules for Doom Emacs.

    Emacs Lisp 25 2

  5. community Public

    Public resources and discussions board for the @doomemacs project.

  6. wiki Public

    The public wiki hosted on @doomemacs/community's repo.

    Nix 1

Repositories

Showing 10 of 15 repositories
  • doomemacs Public

    An Emacs framework for the stubborn martian hacker

    Emacs Lisp 20,608 MIT 3,114 616 (37 issues need help) 43 Updated Jun 28, 2025
  • .github Public
    7 2 0 0 Updated Jun 25, 2025
  • wiki Public

    The public wiki hosted on @doomemacs/community's repo.

    Nix 1 MIT 0 0 0 Updated Jun 25, 2025
  • docs Public
    Nix 1 MIT 0 0 0 Updated Jun 25, 2025
  • community Public

    Public resources and discussions board for the @doomemacs project.

    0 MIT 0 3 0 Updated Jun 25, 2025
  • themes Public

    A megapack of themes for GNU Emacs.

    Emacs Lisp 2,250 MIT 405 69 11 Updated Jun 14, 2025
  • snippets Public

    The Doom Emacs snippets library

    YASnippet 308 MIT 99 6 2 Updated May 2, 2025
  • ci Public

    (WIP) A Github action that sets up a Doom Emacs environment for CI/CD.

    17 MIT 2 2 1 Updated Sep 7, 2023
  • discord-bot Public archive

    DoomBot, your friendly neighborhood demon slayer

    JavaScript 5 MIT 4 1 2 Updated Sep 7, 2023
  • discourse-theme Public archive

    The theme for Doom Emacs' DIscourse

    SCSS 10 MIT 4 2 0 Updated Sep 7, 2023