holochain-run-dna
A small and temporary cli tool to execute holochain and install the given DNAs. This emulates the behaviour that hc run had.
This tool:
- Executes the
holochaincommand with default debug level oninfo - By default uses a temporary database that will be cleaned after exit
- Installs the given DNAs in the same installed app id
test-app, and listening to 8888. - Is configurable by command-line for other installed-app ids, ports, and network params.
If more configuration parameters are wanted, PRs and issues are welcomed at https://github.com/holochain-open-dev/holochain-run-dna.
Only to use for development purposes. For production purposes, use directly the holochain command.
Requirements
You need to have the holochain binary already installed and accessible in the PATH environment variable.
If the holochain conductor crashes with a problem related to lair-keystore, uninstall it (which lair-keystore and rm <PATH_OF_KEYSTORE>) and run holochain -i. It should automatically install the appropriate version of lair-keystore.
Installation in project
npm install -D @holochain-open-dev/holochain-run-dnaInstall it in your project for it to be accessible to anyone that clones the project.
Global installation
npm install -g @holochain-open-dev/holochain-run-dnaInstall it globally if you want to be able to use it from the terminal anywhere in your system.
Usage
holochain-run-dna -p [PORT] -r [RUN_PATH] -u [PROXY_URL] -i [INSTALLED_APP_ID] [DNA_PATH, DNA_PATH...]Example: holochain-run-dna -p 8889 ./test.dna.gz
The port is optional, the default is 8888.
Use of -c flag**
Use the -c flag To install multiple happs and pass a path to a config.
Example: holochain-run-dna -c ./example-config.yml
To know how the config looks like please look at the example-config
Note: Currently different happs will be installed with different agent by default.
To change the debug level:
RUST_LOG=debug holochain-run-dna [DNA_PATH, DNA_PATH...]