Command Line Tool

It is possible to run drasyl from the command line using the drasyl command. The drasyl command makes it possible to start up drasyl nodes, generate identities, and more directly from the command line.

You can download the drasyl command from GitHub. The download includes a bin/drasyl executable for Linux/macOS users and a bin/drasyl.bat for Windows users.

Run drasyl help to get an overview of available commands and flags:

$ drasyl help
drasyl Command Line Interface: A collection of utilities for drasyl.

Usage: drasyl [COMMAND]

  generate-completion  Generate bash/zsh completion script for drasyl.
  generate-identity    Generate and output a new identity.
  generate-pow         Generate and outputs a new proof of work for a given
                         public key.
  help                 Displays help information about the specified command
  node                 Run a drasyl node.
  node-rc              Remote controlling a node.
  perf                 Tool for measuring network performance.
  pubkey               Dervices the public key and prints it to standard output
                         from a private key given on standard input.
  tun                  Create a local network interface routing traffic to
                         given peers.
  tun-rc               Remote controlling a network interface created by the
                         "tun" command.
  tunnel               Expose safely local networked services behind through
                         NATs and firewalls to other computers.
  version              Shows the drasyl version number, the java version, and
                         the architecture.
  wormhole             Transfer a text message or file from one computer to
                         another, safely and through NATed firewalls.

The environment variable JAVA_OPTS can be used to pass options to the JVM.

Docker

The drasyl/drasyl image provides the drasyl command to the host. So no need to install drasyl on your machine, you can just use this docker image.

For instance:

$ docker run -i -t drasyl/drasyl version
- drasyl-cli.version 0.8.0 (a773985)
- drasyl-core.version 0.8.0 (a773985)
- drasyl-node.version 0.8.0 (a773985)
- drasyl-plugin-groups-client.version 0.8.0 (a773985)
- drasyl-plugin-groups-manager.version 0.8.0 (a773985)
- java.version 11.0.15
- os.name Linux
- os.version 5.10.47-linuxkit
- os.arch amd64

To run a node:

# generate an identity (this can take some time)
$ docker run -i -t drasyl/drasyl generate-identity | grep -v "WARNING:" > drasyl.identity

# start a node
$ docker run -i -t -p 22527:22527 \
    -v $PWD/drasyl.identity:/drasyl.identity \
    drasyl/drasyl node

This command passes the just generated identity to the docker container and then launch the drasyl node command.

Homebrew

The drasyl command can also be downloaded with Homebrew:

$ brew install --HEAD drasyl/tap/drasyl

Chocolatey

The drasyl command can also be downloaded with Chocolatey:

$ choco install drasyl