Installation (MacOS & Linux)

Once the Emacs is installed, we can follow these steps to install Doom Emacs. Full guide is here.

  1. Clone the repository and run the install command using bin/doom utility.
git clone https://github.com/hlissner/doom-emacs ~/.emacs.d
~/.emacs.d/bin/doom install
  1. So that, we don’t have to type ~/.emacs.d/bin/doom every time, place the following .bashrc or .zshrc file:
export PATH="$HOME/.emacs.d/bin:$PATH"
  1. We also need to move configuration files to dotfiles and stow it cleanly:
cd ~/dotfiles # OR cd ~/omarchy-dotfiles
mkdir -p doom
mv ~/.doom.d ~/dotfiles/doom/ # or mv ~/.doom.d ~/omarchy-dotfiles/doom/
rm -rf ~/.doom.d
stow doom
  1. We can verify the symlink by running:
ls -ld ~/.doom.d
  1. Open Emacs (either GUI / App or TUI through Terminal). Doom Emacs should be ready πŸŽ‰.
  2. Some fonts / icons might not be rendering right. It is because we might be missing Nerd fonts. We can install the fonts by pressing Meta + x (M-x) and then running the command:
nerd-icons-install-fonts
  • If running GUI on MacOS, M-x is Command + x. But if running Emacs over SSH through MacOS, we can press M-x using SPC + :.
  1. Restart Emacs. Fonts and icons will be working now.

Configuration

Setting Theme

I love to use gruvbox theme for Emacs.

  1. Open your Doom config:
~/.doom.d/config.el
  1. Update the theme line:
(setq doom-theme 'doom-gruvbox)

For configuration full guide, read here.