- 4GB+ RAM (16GB+ recommended)
- 4+ CPU (6+ CPU recommended)
- 30GB+ available disk space
- Internet connection
After installing Nix, log out of your user account and log in again. Or, to save effort, run this command to get your terminal to recognize the newly installed commands:
Check that it installed correctly:
You should see something like:
If you’d like to know more about Nix and why we use it, you can find more information here.
Installing the Holochain dev tools¶
Now that you have installed Nix, you can install and run a development shell that contains all the prerequisites, including the correct Rust and nftgamef.com versions and the Holochain tools. This shell won’t interfere with your current system configuration.
Optional: configure Cachix for faster load times¶
To significantly speed up the load times for the next step you can make use of our Cachix instance. If you don’t it’ll take a long time, because it needs to compile the Holochain binaries.
Please try the following command to set up the cache.
With a recent enough Nix you can use this ad-hoc command:
If does not work your version of Nix might be outdated. In this case please try steps 2 and 3 from the documentation on nftgamef.com.
Use this one-liner to load Holonix:
Once this is finished, you’ll be in the Holonix shell with all the developer tools at your disposal. You will see a new bash prompt that looks like:
Test that you have Holochain by running:
You should see something like this:
Once you exit the shell you’ll be back to your usual system shell, with all Holochain-specific bits cleaned up.
Using the Holochain dev tools¶
Maybe you are interested: Crypto and Taxes: 7 Important Questions and Answers – FindLaw
You can re-enter the Holonix shell with the same command you used initially:
It will always keep you up to date with the newest stable version of Holochain and the dev tools. If you need to work offline, read the advanced installation guide.
Read through our advanced installation guide for tips and tricks on making your development environment easier to work with.
Using Holochain in a repository with a pinned Holochain version¶
Holochain is currently in rapid development, which means newer versions introduce new features and breaking changes. This means that it’s likely that the version that you get with nix-shell nftgamef.com won’t always work with existing hApp repositories.
To solve this, repositories of hApp projects can use Nix to pin the appropriate Holochain version to work well for that hApp. To do this, the project needs to have a nftgamef.com file in the root folder of the repository. Here you can see an example of that file.
If you are trying to set up a repository that comes with a nftgamef.com file, you must not be inside the nix-shell provided by nftgamef.com. Instead, simply navigate to the folder with the nftgamef.com file and run:
This will do the same exact process that nix-shell nftgamef.com does, but will download the specific Holochain versions that that project is set up for.
Note that this can take a long time to download and compile the binaries. In the future we should be able to make this quicker by adding a build cache so that you only need to download the already compiled binaries.
Maybe you are interested: RSA — PyCryptodome 3.14.1 documentation
- Read through the Holochain Core Concepts.
- Try building and running a sample hApp.
- Scaffold your own hApp using our RAD tool.
- Build your development skills in the Holochain Gym (community-created).
- Learn more about Rust in the Rust book.
- Take a look at the developer documentation.
- SDK and API references
- Rust HDK overview
- Join the discussion at the developers’ forum.