Search by Tags

Linux Terminal and Basic Usage - Linux


Your progress



In this module you will:

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

To facilitate the understanding of the lessons, check our typographic convention below:

Typographic Conventions


For this Getting Started Guide:

  • Development computer with Ubuntu 18.04 LTS.
    • Commands and instructions may vary slightly on other Ubuntu releases and Linux distributions.
  • Successfully completed the previous lessons from this guide.

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.

In your host PC, install PuTTy:

$ sudo apt install putty

Step 2

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

  • PuTTY Icon

    PuTTy Icon

  • PuTTY Configuration Window

    PuTTy Configuration by using board's IP

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

    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.

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 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

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


Are there any alternatives to PuTTY?