Installing the weavedconnectd daemon on your Raspberry Pi

Please note: weavedconnectd is not recommended for new designs.  This information is made available to support users who have already deployed weavedconnectd.

Check the OS Version

First, you will need to determine which version of the OS is installed on your Pi.

pi@raspberrypi:~ $ cat /etc/os-release
PRETTY_NAME="Raspbian GNU/Linux 8 (jessie)"
NAME="Raspbian GNU/Linux"
VERSION="8 (jessie)"

This example shows that the release is at the "Jessie" level which as of April 2017 is current.  The weavedconnectd installer is up to date at the Raspbian repository, so you can use the "apt-get" command to get the latest version.

If you are using the Wheezy version of Raspbian, or to support other ARM boards using Debian (such as BeagleBone Black and Wandboard), please follow the installation directions here.

Install the weavedconnectd package

First, get the latest repositories:

sudo apt-get update

Next, download the weavedconnectd package:

sudo apt-get install weavedconnectd

If you are using Jessie, and you have not installed the weavedconnectd package previously, you will see:

If you had previously installed weavedconnectd, the following output shows that you are already up to date.

Run weavedinstaller to configure service attachments

Next, run

sudo weavedinstaller

to launch the interactive installer.

After some initialization info, you will see this menu:

If you have not already created an account, select 2 then press Enter.  Then follow the on-screen instructions to enter your e-mail.  We will send you an e-mail with a verification code that you must enter by selecting 3 from this menu. After that, your account is active and you can add devices and services.

If you already created an account, select option 1, then log in. Note that the password is not displayed as you type.

Next, as there are no services yet installed, you will be asked to enter the Device Name.  Valid characters include numbers, letters, space, underscore, and dash.

This is the initial view of the Installed Services Menu.  All that you have at this point is the Device Name.

Press 1 to attach to one of your services.

Select the type of service you are connecting to.  Options 1 through 3 are predefined for the most common use cases.  You can choose a different port during installation of options 1 through 3.  Select option 4 to configure for other use cases.

Installing a attachment for SSH

We recommend having a enabled SSH connection even if your primary use case is something else.  That way, you can easily get to a console for troubleshooting if needed.

Note: recent versions of the Raspbian Jessie OS do not enable SSH by default as a security measure.  You will need to run the raspi-config program on your Raspberry Pi to enable the SSH daemon.

Select 1 at the Protocol Selection Menu to configure an attachment for SSH.

For options 1, 2, and 3, a default port has been chosen.  Sometimes this needs to be changed to another value, so you have that option here.  Unless you know otherwise, select the default value.  After taking a few seconds to create the attachment, you will be asked to enter a name for this service.  After you enter the name, a few more seconds passes while it is registered to your account.

Next, you will be returned to the Installed Services menu.  Now your attachment to the ssh service is shown.

We have successfully installed the service connection for SSH.  In the "Service" column you will see the name of the tcp listener program (usually called a "server") which was found on the specified port. 

Learn more about using and SSH here.

Installing a service for a web (http) server

Follow the instructions for SSH above, except choose option 2, "Web (http)" from the Protocol Selection Menu.  You will need to install and configure your own web server.

Installing a service for a VNC server

Follow the instructions for SSH above, except choose option 3, "VNC" from the Protocol Selection Menu.  Learn more about using with VNC here.  Port 5901 is the default used by tightvncserver.  It may be different for other VNC programs.

Possible Problems

If you see "WARNING-NONE" in the Services column, it means that no tcp listener was found on that port.  This could mean:

  • The desired program is not installed.  Note that while the weavedconnectd installer has options for configuration with VNC and web servers, these programs are not installed by default.
  • The program is installed, but it's not running.  Check to make sure the program is running and works over the LAN.
  • The program is installed and running, but it's on a different port than you have specified.  To see all tcp listeners running on your device along with the ports they are using, run the command

sudo netstat -apn | grep tcp | grep LISTEN

Lines beginning with "tcp" represent TCP v4 sockets.  Lines beginning with "tcp6" represent TCP v6 sockets. 

An entry such as means "listen on all interfaces for traffic on port 5901".  This corresponds above to 11419/Xtightvnc.  This indicates that process ID 11419 is the Xtightvnc server.

An entry such as means "listen on interface (localhost) for traffic on port 3350".

The output shown is just one possibility and depends on how you have your device configured.  Check the documentation for netstat to learn more about this very powerful utility.









Was this article helpful?
3 out of 3 found this helpful
Have more questions? Submit a request


Please sign in to leave a comment.