Search by Tags

Linux Terminal and Basic Usage


Your progress



In this module you will:

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


For this Getting Started Guide:

  • Successfully completed the previous lesson from this guide.
  • Linux Machine (We tested this guide on Ubuntu 18.04 LTS. However, it can work on other distributions.).

For this lesson:

  • Make sure the host computer and target device are connected to the same network.
  • 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

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

On your Linux machine, head to PuTTY's website, download and install the client.

Step 2

Open PuTTY and insert your board's IP address 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. Click "Open" and accept the next dialog.

  • PuTTY Configuration Window

    PuTTy Configuration by using board's IP

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

  • PuTTY login

    PuTTY login

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.

Step 2 - Alternative - Using hostname instead of the IP address

If you have the board connected to the network but you don't know its IP address, you can also connect by the board's hostname.

The board's hostname is composed on the following format: <Toradex model>-<processor>-<serial number>

You can find the module's serial number on the sticker on the board.

  • Module sticker

    Apalis iMX8 sticker

In the example of the module above, the board's hostname is apalis-imx8-06438725.

If you are not sure what is the model or processor name of your board, please, refer to Toradex Products page

On PuTTy, insert the hostname of your board. Click "Open" and accept the next dialog box.

  • PuTTY Configuration Window

    PuTTY Configuration Window

Step 3

The success of this step 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, refer to the FAQ at the end of this lesson.

Step 4

If you are new to Linux commands, read the basic Linux commands article.


Are there any alternatives to PuTTY?