Holo Nixpkgs

Modules, packages and profiles that drive Holo, Holochain, and HoloPortOS.

Binary cache

On NixOS, add the following to /etc/nixos/configuration.nix and rebuild:

{
  nix.binaryCaches = [
    "https://cache.holo.host/"
  ];

  nix.binaryCachePublicKeys = [
    "cache.holo.host-1:lNXIXtJgS9Iuw4Cu6X0HINLu9sTfcjEntnrgwMQIMcE="
  ];
}

Otherwise, add https://cache.holo.host/ to substituters and cache.holo.host-1:lNXIXtJgS9Iuw4Cu6X0HINLu9sTfcjEntnrgwMQIMcE= to trusted-public-keys in Nix config file:

substituters = https://cache.holo.host/ https://cache.nixos.org/
trusted-public-keys = cache.holo.host-1:lNXIXtJgS9Iuw4Cu6X0HINLu9sTfcjEntnrgwMQIMcE= cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY=

For single-user installs (nix-shell -p nix-info --run nix-info prints multi-user: no), Nix config file is in ~/.config/nix/nix.conf.

Otherwise, for multi-user installs, Nix config file is in /etc/nix/nix.conf and changing it requires root access.

HoloPortOS

HoloportOS is an operating system based on NixOS that supports running Holochain applications.

Changing HPOS to Track develop vs. master

On your HoloPort or HPOS VM, the following command will alter your subscribed nix channel.

To track develop:

• nix-channel --add https://hydra.holo.host/channel/custom/holo-nixpkgs/develop/holo-nixpkgs
• nix-channel --update (change develop above to appropriate repo branch... e.g. master, rc-version)

Your HoloPort or HPOS VM should now upgrade to your desired channel at the next auto-upgrade interval.

To begin the upgrade immediately, use the following command:

• systemctl start holo-nixpkgs-auto-upgrade.service

QEMU

If you have Nix installed, checkout the repo, enter nix-shell and then run hpos-shell. That will launch a HoloPortOS VM against current state of your local checkout, which is useful for iterative development.

VirtualBox

Download the latest HoloPortOS VirtualBox OVA: https://hydra.holo.host/job/holo-nixpkgs/master/holoportos.targets.virtualbox.x86_64-linux/latest/download-by-type/file/ova

Refer to VirtualBox manual, chapter 1, section 1.15.2.