x86_64 Hardware Support

Torizon OS supports any x86-64 based device. Since specific setup instructions depend on your hardware platform, we provide validated instructions for VirtualBox and QEMU to help you get started quickly.

How to Get Started

Setup

On VirtualBox

1. Download the .vdi Torizon OS image from the Toradex Download Center.
2. Setup and start a virtual machine using the following commands:

   # Setup new machine Common-Torizon
   $ VBoxManage createvm --name Common-Torizon --ostype "Linux_64" --register --basefolder "$HOME/CommonTorizonVBoxVM"
   $ VBoxManage modifyvm Common-Torizon --firmware efi64
   # Attempt at serial connection (cant communicate but can inspect serial logs via 'tail -f /tmp/serial')
   $ VBoxManage modifyvm Common-Torizon --cpus 2 --memory 2048 --vram 256 --graphicscontroller vmsvga --uart1 0x3F8 4 --uartmode1 file /tmp/serial
   
   $ VBoxManage storagectl Common-Torizon --name "SATA Controller" --add sata --bootable on
   $ VBoxManage storageattach Common-Torizon --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium "torizon-docker-intel-corei7-64.wic.vdi"
   # Port forwarding for SSH on port 2222
   $ VBoxManage modifyvm Common-Torizon --nat-pf1=ssh,tcp,,2222,,3791 --nat-pf2=ssh_tor,tcp,,2223,,22
   
   $ VBoxManage startvm Common-Torizon

On QEMU

1. Download the .wic Torizon OS image from the Toradex Download Center.
2. Run the image with QEMU using the following command:

   $ qemu-system-x86_64 -drive if=virtio,file=torizon-docker-intel-corei7-64.wic,format=raw -no-reboot -cpu host -nic user,hostfwd=tcp::2222-:22 -machine pc -vga virtio -m 4096 -bios /usr/share/ovmf/OVMF.fd -enable-kvm -serial pty

On an Embedded x86 Board

The instructions depend on the specific board and, therefore, this workflow is not validated. In most cases, a .wic image and a method to flash it to an SD card are required. Refer to your vendor's documentation for board-specific procedures. A generic step-by-step outline is provided below:

1. Download the .wic Torizon OS image from the Toradex Download Center.
2. Flash the SD card with the following command, replacing <sdcard-device-node> with your SDCard device node (e.g. /dev/sdb):

   $ sudo dd if=torizon-docker-intel-corei7-64.wic of=/dev/<sdcard-device-node> bs=4M status=progress

3. Refer to the board vendor's documentation to boot from the SDCard and establish a serial connection.

For more information, or if you want to build Torizon OS yourself using the Yocto Project, read the full documentation for x86 hardware on GitHub.

Running Torizon OS

1. Start the VM/QEMU/board and login with the default credentials. The default password for the user torizon is torizon. You will be prompted to change it on the first login.
2. Create an account on https://app.torizon.io/.
3. Go to the Hardware > Devices tab and click "Provision Device" to connect your device to the Torizon Cloud.
4. Refer to the Remote Access article to learn how to access your device remotely over SSH through the Torizon Cloud. Check the Torizon Cloud documentation for additional features.