Skip to main content

Running the Host

The wasmCloud host runtime is an Elixir mix release that includes various scripts for running and managing an application. By running bin/wasmcloud_host, you'll see a variety of commands and options:

./bin/wasmcloud_host
Usage: wasmcloud_host COMMAND [ARGS]

The known commands are:

start Starts the system
start_iex Starts the system with IEx attached
daemon Starts the system as a daemon
daemon_iex Starts the system as a daemon with IEx attached
eval "EXPR" Executes the given expression on a new, non-booted system
rpc "EXPR" Executes the given expression remotely on the running system
remote Connects to the running system via a remote shell
restart Restarts the running system via a remote command
stop Stops the running system via a remote command
pid Prints the operating system PID of the running system via a remote command
version Prints the release name and version to be booted

There are a variety of commands and options to get used to here, we generally only focus on the commands that manage starting, stopping, and debugging a wasmCloud application.

  • To start the host running in the current terminal, which is recommended to easily view logs, you can use start

    bin/wasmcloud_host start
  • Alternately, you can start it in the background as a daemon with daemon

    bin/wasmcloud_host daemon

    and stop it with

    bin/wasmcloud_host stop

    or restart it with

    bin/wasmcloud_host restart

    If you choose this option, host logs will be located under tmp/log and can be viewed with:

    tail tmp/log/erlang.log.1
  • If you're already familiar with Elixir and iex, Elixir's interactive shell, and want to dive into the host's internals, execute Elixir statements, and set breakpoints, start the host including an interactive console with:

    bin/wasmcloud_host start_iex