This document describes how to log in to Raspberry Pi using a remote terminal via SSH protocol.

If you do not already have Raspberry Pi installed, first go to the document Raspberry Pi Installation.

You can log in two ways:

  1. Using an IP address

    In this case, you need to find out what address the DHCP server assigned to your Raspberry Pi.

  2. Using the DNS name

    This can either be:

    • hub.local in the case of the BigClown Raspbian distribution

    • raspberry.local in the case of the original Raspbian distribution

Instructions for Windows

  1. Download the PuTTY program.

  2. Run PuTTY and create an SSH session:

    • Use the hostname hub.local (or raspberry.local if you are using the original Raspbian distribution), or the Raspberry Pi IP address

    • Enter the login pi

    • Enter the password raspberry

    • Give the session a name and save it for the future use

Instructions for macOS and Linux

  1. Run the Terminal application and connect to the Raspberry Pi either:

    • using the IP address instead ...:

      ssh pi@...
    • or using the DNS name hub.local if you are using the BigClown Raspbian distribution:

      ssh pi@hub.local
    • or using the DNS name raspberry.local if you are using the original Raspbian distribution:

      ssh pi@raspberry.local
  2. Enter the password raspberry.

Changing the password

Remember to change the default password when you first login. You can make the change using the following command:


System Update

For reasons of security and stability, it is important to keep the system up to date. The system consists of packages and you can update them with the following command:

sudo apt update && sudo apt upgrade
Chapters in this document:
Edit this page

We will inspire you!

You will get regularly our Clownsletter with real projects from other Makers. Do not miss it!

By sign up you will know how even you can inspire others and get €100 discount coupon!