How to setup a Raspberry Pi 2 or 3 for Azure IoT Hub scenarios

Preparing your Raspberry Pi 2 (or 3)

In this tutorial you will learn how to setup your Raspyberry Pi without keyboard, mouse, and monitor.
Some of my other tutorials are based on this type of installation.

Raspberry Pi 2

Step 1: Download Raspbian Image

Please download the latest version of Raspbian Desktop from the following website:

Step 2: Download SD Card Tool Etcher

To flash the image to your local SD Card please use the Etcher Tool.

Etcher - Tool to flash SD cards

You can download Etcher from this link:

The steps in the tool are very simple:
1. Select image
2. Select SD Card
3. Start

Step 3: Prepare headless access to the Raspberry PI

The headless installation reduce the need of connecting a keyboard or a monitor to the Raspberry Pi. This reduce the cost of hardware, and the cable chaos on your desk. To be able to connect to the Pi, you need SSH, which is disabled by default. To enable it before the first use of your SD Card. You just need to create an empty file in the root folder of the SD Card.

Empty ssh file in rootfolder

Step 4: Start your Raspberry PI with the SD Card and find it on the network

Now you can put the SD Card into your Pi. Please connect you Pi to your local area network with a cable to get a valid IP-Address. And don't forget to power on your device ;-)

To find the IP Address of your Raspberry Pi, you can use the Advanced IP Scanner to get a list of all "devices" in your network.

Advanced IP Scanner

Step 5: Connect via ssh

I'm using Putty for ssh. With the IP-Address, Username pi and Password raspberry, you're ready to connect.

Change Password is strongly recommended

Everyone knows the password of a new installed Raspberry Pi, so please changed it directly with the command:

$ passwd

Step 6: Update to latest version of Raspbian

Maybe the image is a few days old. To get the latest and greatest version of Raspbian use the following commands:

$ sudo apt-get update
$ sudo apt-get dist-upgrade

Step 7: Configure access for remote desktop

To access your Raspberry via another computer over a remote desktop connection, you can use vnc (which is already installed in the Raspian Image). You have to enable it first.

Headless option

If you are connected only via network. You can use:

sudo raspi-config  

Display/keyboard/mouse connected

Enabling VNC

After enabling VNC, a reboot is required.

Now you can access your Pi with the VNC Viewer from your local machine with the IP-Address you detected in Step 4.

You can install the VNC Viewer from here:

Step 8: Create Hostname

For an easier access to your Pi, you should assign an unique hostname in the Pi Configuration Tool. Default hostname is Raspberry, which could be very confusing, if you have several Raspberry's in your network.

Using Raspberry Pi Configuration to set Hostname

A reboot is required after this step.

Step 9: Create a Share for your source

To access the Pi via a file share, you have to install Samba. To do so, open a terminal window and type:

sudo apt install -y samba  

To configure samba:

sudo nano /etc/samba/smb.conf  

First Change [global] section

  workgroup = WORKGROUP
  wins support = yes

The configure file share:

  only guest=no
  create mask=0777
  directory mask=0777

Save the file and exit.

Now add user "Pi" to the share and set file share password:

sudo smbpasswd -a pi  

Restart samba server:

service smbd restart  

Now you should be able to access the Pi over a file share in your Windows Explorer. Enter the following url in the Windows Explorer address bar.

If it doesn't work, try

DNS on Windows needs sometimes a while

Step 10: Install Docker

Docker is also available for the Raspberry PI:

The installation is done with one single command:

curl -sSL | sh  
sudo usermod -aG docker pi  

Issue: Can't connect to container registry (sometimes)


add the following line to /etc/resolv.conf

Issue: 500 Server Error when working with IoT Edge Preview

There is currently an Issue with version 17.11. You need to downgrade to Version 17.09.

sudo apt-get install -y docker-ce=17.09.0~ce-0~raspbian --allow-downgrades

Additional Step: Install dotnet core


sudo apt-get install curl libunwind8 gettext

curl -sSL -o dotnet.tar.gz 

sudo mkdir -p /opt/dotnet && sudo tar zxf dotnet.tar.gz -C /opt/dotnet 

sudo ln -s /opt/dotnet/dotnet /usr/local/bin

dotnet --help  

Version 2

# Update Ubuntu 16.04
sudo apt-get -y update

# Install the packages necessary for .NET Core
sudo apt-get -y install libunwind8 libunwind8-dev gettext libicu-dev liblttng-ust-dev libcurl4-openssl-dev libssl-dev uuid-dev

# Download the latest binaries for .NET Core 2 

# Make a directory for .NET Core to live in
mkdir /home/ubuntu/dotnet

# Unzip the binaries into the directory you just created
tar -xvf dotnet-runtime-latest-linux-arm.tar.gz -C /home/ubuntu/dotnet

# Now add the path to the dotnet executable to the environment path
# This ensures the next time you log in, the dotnet exe is on your path
echo "PATH=\$PATH:/home/ubuntu/dotnet" >>  
sudo mv /etc/profile.d

# Then run the command below to add the path to the dotnet executable to the current session

Remove need of sudo for dotnet

sudo usermod -aG dotnet pi  


Now you have a Raspberry Pi, which is ready to use with VNC and File Access with a share. This setup is used in the next tutorials.