All materials and notes for dowse workshops are collected here

Federico Bonelli c10039811a guide edit 3 years ago
Nodered 38c2ceb8c5 added nodered examples 3 years ago
OSC f495e4f0d2 minor change 3 years ago
docs 54a4dad8aa some changes 3 years ago
image 597e895e0f Debrief WS Copenhagen 3 years ago c10039811a guide edit 3 years ago fbaabe6bb6 checks 3 years ago
logo_full.png 597e895e0f Debrief WS Copenhagen 3 years ago
logo_small.png 597e895e0f Debrief WS Copenhagen 3 years ago fbaabe6bb6 checks 3 years ago

Notes for Dowse workshops setup and materials


  • Web site is
  • Dyne is spelled as here; our website is
  • irc channel is #dowse, feel welcome also to join in via
  • fredd email is
  • Mailing list is
  • PAD for CHP ws:

How to deploy Dowse on a Raspberry Pi

  • you need:
  • a Raspberry Pi (version 2 or 3)
  • a power supply with at least 2A power (the Raspberry Pi 3 needs 2.5A) and a Micro-USB connector
  • a MicroSD card with at least 2GB capacity
  • the Dowse image file from (until the new file is up you can take it from here. This is the image that Jaromil gave out at the workshop on September 27: )

  • use your computer to clone the image onto the SD card (

  • put the SD card into your Raspberry Pi

  • connect it to your access point/router via an Ethernet cable

  • optional: you can connect a monitor via HDMI and keyboard and mouse, but you'll have to do it before powering it up. This might be useful at the beginning because you can log in to it right away, get its IP address and change settings, etc.

  • connect it to power to boot it up

  • Dowse should now be running!

  • Log in to your home router/access point

  • disable DHCP (also for IPv6 if that is on, as apparently Windows 10 uses IPv6 for DNS)

  • The router will give you the Dowse box's IP address. With the default SD card image Dowse takes its IP via DHCP

  • Use that to SSH into your Dowse box, i.e. with ssh root@

  • optional but probably a good idea: set up a static IP address for your dowse box (edit /etc/network/interfaces)

There are two users set up, root and dowse. The default password for root is toor, for the user dowse it is dowse. Log in as dowse to go straight to the interactive Dowse console.

How to say Dowse is running:

  • find out its IP address. Your router might tell you if you log in to its web interface, or try an app like

  • Let's assume it's Open a Terminal and type ping

  • or open in your browser. You should see the captive portal. Enter yourself as the administrator.

  • another way to check that the captive portal works: dig

How to say dowse is running on WIN machines

  • Open the startmenu and type as a command to run 'cmd' - it will open a commandprompt
  • run 'ping'
  • if it says 'xx bytes from … time=xx ms' a few times, it works!
  • Open '' in your browser


  • Dowse runs your DHCP. If it fails, try to disable the DHCP on your router
  • Check if there is a seperate DHCPv6 that might cause IPv6 resolving issues (Windows 10 uses IPv6 for DNS)

How to start OSC

ssh into the dowse box (See 'Putty' further down if you are on Windows)

then start:

/usr/local/dowse/bin/dowse-to-osc osc.udp://ip-of-machine-to-send-to:port/path

to make it start at every boot, put this line inside the file /etc/rc.local (edit as root)

Node Red

A graphical editor to edit node patches/flows. Such flows allow reacting to input (like Dowse MQTT data). Not required to use Dowse. You can write your own programms or create gadgets that recieve MQTT or OSC data and do things with it.

after installing node red you can follow a great tutorial :

(it's also already installed on the dowse box, right? How do I start it on there?)


Installation Linux

  • install node.js
  • in terminal sudo npm install -g --unsafe-perm node-red

Installation Mac

Installation Win

go to node.js website and install node.js

open node terminal type: sudo npm install -g --unsafe-perm node-red


Gource allows to visualize the data using a colorful, dynamic and animated graph. It's processor-intensive so it should be run on a client machine.

How to use Gource on a windows machine

  • Windows does not come with SSH. It is possible to use an alternative SSH-client called 'Putty' (Download URL:
  • After installing, there is a ssh console client called plink.exe. It might not be in your 'PATH'. To run it from windows commandline, you need to specify the whole path. E.g. "c:\Program Files\Putty\plink.exe …"
  • When piping the output to gource, Windows does not show the interactive prompot for the password. But you can specify the password via the commandline switch -pw

<full_path_to_putty>\plink.exe -pw dowse -l dowse /usr/local/dowse/bin/dowse-to-gource | <full_path_to_gource>\gource.exe --log-format custom -


  • Instead of cmd/powershell, use a shell that knows SSH and such tools like ''
  • Untested, please document :-)

On Mac:

install via homebrew First install brew if it isn't already, then just do brew install gource Once installed, start gource on your own laptop with ssh -l dowse /usr/local/dowse/bin/dowse-to-gource | gource --log-format custom - my favourite gource command: ssh -l dowse /usr/local/dowse/bin/dowse-to-gource | gource --log-format custom -e 0.5 --bloom-multiplier 2.0 --bloom-intensity 0.1 --background F7EFDB --font-size 18 --font-colour 000000 --logo ~/devel/dowse-workshops/logo_small.png -

password is dowse


you can also get dns queries listed directly in your shell i.e. with ssh -l dowse /usr/local/dowse/bin/dowse-to-gource

Notes about making the workshop better (feel free to add)

  • Remember that to Setup dowse for WS takes always a bit
  • Start a etterpad for the workshop to begin with
  • point to a page already populated with documentation,
  • instruct on how to change the documentation
  • Bring white board markers !
  • default dowse is partymode (everyone gets online immediately)


Node MCU

Furhter research

IoT bad and good ideas

Links to funky hacks of IoT devices

Every now and then a funny (or a scary) IoT hack comes available. I have been twitting them for a wile with the #dowse hashtag. A small selection of stories is here below.