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:

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