readme	reference	faq
this document	docs/reference.md	docs/faq.md

nix-doom-emacs

	Status
Build on master
Dependency updater
Matrix Chat

Nix expression to install and configure doom-emacs.

nix-doom-emacs (also commonly referred to as NDE in chatrooms) is a project with lots of moving pieces and hacks. Users are expected to know their way around using (and especially debugging) Nix and Emacs Lisp in order to use this project.

The expression builds a doom-emacs distribution with dependencies pre-installed based on an existing ~/.doom.d directory.

It is not a fully fledged experience as some dependencies are not installed and some may not be fully compatible as the version available in NixOS or emacs-overlay may not be compatible with the doom-emacs requirements.

Quick Start

If you want to get a taste of nix-doom-emacs, you can run nix run github:nix-community/nix-doom-emacs Which will run nix-doom-emacs with an example configuration.

Pick which setup you're using here (if you're not using NixOS or Home-Manager, then you should use standalone):

Home-Manager

	NixOS	Standalone
[Flake + Home-Manager](./docs/reference.md#flake--home-manager)	[NixOS](./docs/reference.md#nixos)	[Standalone](./docs/reference.md#standalone)