Search by Tags

Linux Terminal and Basic Usage


Your progress



In this section you will:

  • Be introduced to PuTTY.
  • Communicate with the board through SSH.
  • Be introduced to basic Linux commands.
Typographic Conventions


For this Quickstart Guide:

  • Development computer with Windows 10 version 2004 (a.k.a. May 2020 update) or higher.
  • Successfully completed the previous lesson from this guide.

For this lesson:

  • Make sure the host computer and target device are connected to the same network.
  • Local network with DHCP assigning IP addresses to all connected devices.
  • Have your board's IP address, as seen in the last lesson.

Note: Carefully read this module's cover page clicking on "Module 1: Unboxing and Bring-up" on the left menu bar before starting this lesson.

Step 1

Write down the unique serial number of your computer on module for later usage. You can find the module's serial number on the sticker on the board:

  • Computer on Module sticker

    Computer on Module sticker

In the example of the module above, the board's unique serial number is 06438725.

Step 2

From the unique serial number, you generate your board's hostname, composed on the following format: <family>-<processor>-<serial number>

In the example from step 1, the board's hostname is apalis-imx8-06438725.

If you are not sure what is the family or processor for your board, please, refer to Toradex Products page.

Step 3

Turn your board back on. Don't worry about the prompt that appears on the monitor connected to your board, for now.

On your development PC, head to PuTTY's website, download, and install the client.

Step 4

Open PuTTY and insert either your board's IP address or board's hostname at Host Name (or IP address) field. Leave the port configured as 22, which is the default port for the SSH server running on the board, and the other entries as is.

  • PuTTY Configuration - board's IP or hostname

    PuTTy Configuration - board's IP or hostname

Click Open. On the first connection, Putty will ask permission to add a new server's key entry to Putty's cache. Select "Accept".

  • Putty authorization dialog

    Accept to add the new key to Putty's cache

The default login information is user: torizon and password: torizon. On the first login, you have to change the default password. The login prompt should look like this:

  • PuTTY Login for the First Time

    PuTTY Login for the First Time

Note: as you type the password, there is no visual feedback. In other words, as you type the password, no asterisks or any other characters will be printed.

The PuTTY window will close as soon as you press Enter after re-typing your new password.

Issues to Connect via SSH

If you have issues connecting to the board via SSH, you can alternatively:

Step 5

Re-open PuTTY and create a new SSH connection, as done in the previous steps from this lesson. This time you will be able to login:

  • PuTTY Login for the Second Time Onwards

    PuTTY Login for the Second Time Onwards

The success of using the IP address depends on your router keeping the board IP address the same as the one you have retrieved in the previous lesson. Most IP addresses are assigned using DHCP, which means the board IP address can be changed over time without notice. If you suspect the board IP is incorrect, try the alternative method using the board's hostname.

Step 6

If you are new to Linux, especially to using the command-line, read the basic Linux commands article.


How to Configure my Local Network?
Are there any alternatives to PuTTY?