Using on Nix/NixOS

Note: Emanote documentation is a work-in-progress

Emanote can be easily built using the Nix expressions provided in its source repo.

You will need Nix version 2.4 or greater.

Installing with Nix Flakes

This will provide the emanote command in your environment.

$ nix profile install github:srid/emanote

Using Emanote as a Home Manager service

Home Manager is a Nix-based personal configuration manager. If you use Home Manager, then Emanote has a module that can be imported into your configuration.

Merge or import this config into your ~/.config/nixpkgs/home.nix:

{ config, ... }:
  emanote = import (builtins.fetchTarball "");
in {
  imports = [ emanote.homeManagerModule ];
  services.emanote = {
    enable = true;
    # host = ""; # default listen address is
    # port = 7000;        # default http port is 7000
    notes = [
      "/home/user/notes"  # add as many layers as you like
    package = emanote.defaultPackage.${builtins.currentSystem};

Re-apply your home-manager configuration the usual way (e.g. home-manager switch).

You will then have an emanote command in your profile, and a systemd user service running a live-preview of your notes.

$ home-manager switch
$ systemctl --user status emanote.service
● emanote.service - Emanote web server
     Loaded: loaded (/nix/store/i1af5hdydwcf7y0r55n7fd67dnw5habd-home-manager-files/.config/systemd/user/emanote.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2021-11-02 17:17:04 AWST; 17h ago
   Main PID: 1705303 (emanote)
      Tasks: 26 (limit: 38220)
     Memory: 38.3M
        CPU: 2.884s
     CGroup: /user.slice/user-1000.slice/user@1000.service/app.slice/emanote.service
             └─1705303 /nix/store/9hj2cwk1jakfws0d1hpwa221kcni3j45-emanote- --layers /nix/store/hr7wp1xvqn48b8gy16sdq6k2csrvr8c1-emanote-config;/home/user/notes