Awesome Open Source
Awesome Open Source

~ ~

built with nix

For setting up development environment on any Unix machine (Darwin/Linux). The config officially supports macOS & NixOS & managed by nix


What's in it?

These are the main configs:

Officially supported OSs

  • macOS (tested on BigSur)
  • NixOS (tested on 20.09)


  1. Install Command line tools.
$ xcode-select --install
  1. Run the following command
$ bash -c "$(curl -fsSL"


  • zsh: add these to ~/.zshrc.local
  • For git add your GPG key info in ~/.gitconfig.local
  signingkey =

Don't forget to upload your public key to GitHub!

Note: There needs to be a three-way match on your email for GitHub to show the commit as 'verified': The commit email, github email, & the email associated with the public key

Learn about creating a GPG key and signing your commits here


My email messages are synchronised between the remote server and my computer with isync, I read them with neomutt and search index is built by notmuch.

After linking the dotfiles, there are only a few more things that need to be done.


Each account must authenticate with an IMAP server and an SMTP server. The passwords, need be stored in the OS X keychain.

For Fastmail (or Gmail accounts with two-factor authentication enabled), use an application-specific password.

In order for all this to work, a few items have to be stored in the macOS keychain:

Create a "generic"(A.K.A. "application") keychain item (that is, without protocols, only hostnames):

For sending mail:

Repeat this for each account you want to add.

Synchronizing periodically

Incoming messages are fetched from the remote server when mbsync runs (the executable name for isync).

On macs I use launchd, on NixOS using systemd. You can check mail.nix.


Ahmed El Gabri

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (229,055
Lua (42,671
Macos (9,174
Dotfiles (6,725
Zsh (3,358
Nix (2,761
Neovim (2,578
Kitty (180
Nixpkgs (158
Hammerspoon (143
Nix Flake (82
Weechat (78
Zinit (66
Neomutt (39
Newsboat (34
Nix Darwin (34
Related Projects