Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lukateras/holo-nixpkgs

Modules, packages, and profiles that drive Holo, Holochain, and HoloPortOS
https://github.com/lukateras/holo-nixpkgs

holo holochain nixos nixos-configuration nixos-modules nixpkgs nixpkgs-overlay

Last synced: 3 days ago
JSON representation

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

Awesome Lists containing this project

README

        

# 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
{
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][nixos] that supports running
[Holochain][holochain] applications.

[holochain]: https://holochain.org
[nixos]: https://nixos.org

## 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](https://www.virtualbox.org/manual/ch01.html#ovf-import-appliance).

[nix]: https://nixos.org/nix/