Important: the instructions in this readme are for developers intending work on Holochain code-base itself, not Holochain application developers. If you want to use Holochain, please proceed to the instructions on the quick start installation guide: https://developer.holochain.org/start.html
The following instructions are for developing Holochain Core or the HDK itself
There are three approaches to building and testing Holochain: using nix-shell, make, docker:
The nix-shell command from the nixos team is the preferred way to work with Holochain.
NixOS is an entire operating system but the nix-shell is simply a tool to manage dependencies for an individual shell session.
To install nix-shell:
# basic deps needed on ubuntu/debian
apt-get update && apt-get install -y curl bzip2
# this installs on all (non-windows) systems
curl https://nixos.org/nix/install | shFollow any further instructions output to the terminal during installation.
The Holonix documentation has more information.
Default nix-shell behaviour preserves some of the user's environment, simply
adding to it rather than isolating from it.
This can cause problems if your user has cruft that conflicts with what nix is
doing, e.g. existing cargo or npm installations/environment variables.
If you are seeing an issue in nix-shell that others are not seeing, try using
our isolation script ./scripts/nix/pod.sh to debug the command.
For example:
./nix/pod.sh 'hc-rust-test'or even:
./nix/pod.sh hc-testIn the future we plan to distribute binaries through nixpkgs. This would to enable the following:
# doesn't work yet... watch this space!
nix-shell -p holochain --run holochain ...Note there is an article written on how to build Holochain for Android, read it here.