Happy Setup

Happy is only supported on Linux due to its strong dependence on Linux network namespaces.


  1. Install required libraries:
    sudo apt-get install python-setuptools bridge-utils python-lockfile python-psutil make
  2. Clone the repository:
    git clone https://github.com/openweave/happy.git
  3. Install Happy:
    cd happy
    The make command performs two tasks:
    1. Creates a Happy python package at /usr/local/lib/python2.7/dist-packages
    2. Copies Happy shell scripts to /usr/local/bin
  4. Validate the installation by running a Happy command:
    State Name:  happy
    NETWORKS   Name         Type   State                                     Prefixes
    NODES      Name    Interface    Type                                          IPs

Weave support

Happy supports Weave via OpenWeave, which requires an OpenWeave build and some additional configuration. The quickest way to integrate OpenWeave with Happy is to build the standalone application.

  1. Install the build toolchain and all dependencies required for OpenWeave:
    sudo apt-get update
    sudo apt-get install -y autotools-dev build-essential git lcov /
                         libdbus-1-dev libglib2.0-dev libssl-dev /
                         libudev-dev python2.7 python-software-properties
    sudo apt-get install -y --force-yes gcc-arm-none-eabi
    sudo apt-get update -qq
  2. Clone the OpenWeave repository:
    git clone https://github.com/openweave/openweave-core.git
  3. Build the standalone OpenWeave application:
    cd <path-to-openweave-core>
    make -f Makefile-Standalone
  4. Set the Weave path in the Happy configuration:
    happy-configuration weave_path <path-to-openweave-core>/build/x86_64-unknown-linux-gnu/src/test-apps
  5. Update the $PATH environment variable so it knows where to find Happy-related binaries for Weave:
    export PATH=$PATH:<path-to-openweave-core>/src/test-apps/happy/bin
  6. Test the configuration. You should be able to run Weave commands for Happy:
    State Name:  weave
    NODES                Name       Weave Node Id    Pairing Code
    FABRIC          Fabric Id           Global Prefix


  1. Ensure all virtual nodes and networks are deleted:
  2. Uninstall Happy:
    cd <path-to-happy>
    make uninstall
  3. Delete any other remaining Happy files:
    rm -f ~/.happy_state.json
    rm -f ~/.happy_conf.json
    rm -f ~/.happy_state.json.lock
    cd /usr/local/lib/python2.7/dist-packages
    rm -f happy*

If you use an advanced feature like parallel states, each state should be individually deleted. See Uninstall with parallel states for more information.