Add remote Linux devices

Create connections between generic Linux devices and Qt Creator to run, debug, and analyze applications on them.

{Remote Linux Device in Devices}

Remote Linux Device preferences

Use a wizard to add a device

To use a wizard to add Remote Linux Device:

  1. Go to Preferences > Devices > Devices.
  2. Select Add > Remote Linux Device > Start Wizard.

    {Connection Data wizard}

  3. In The name to identify this configuration, enter a name for the connection.
  4. In The device's host name or IP address, enter the host name or IP address of the device. This becomes the value of the %{Device:HostAddress} variable.
  5. In The device's SSH port number, enter the port number for SSH connections. This becomes the value of the %{Device:SshPort} variable.
  6. In The username to log into the device, enter the username to log into the device and run the application. This becomes the value of the %{Device:UserName} variable.
  7. Select Next to open the Key Deployment dialog.

    {Key Deployment dialog}

  8. In Private key file, select a private key file for authentication. This becomes the value of the %{Device:PrivateKeyFile} variable.
  9. If you don't have a public-private key pair, select Create New Key Pair. For more information, see Generate SSH keys.
  10. Select Deploy Public Key to copy the public key to the device.
  11. Select Next to create the connection.

To change device preferences, go to Preferences > Devices > Devices and select a device in Device.

Manually add a device

To add a device without using the wizard, select Remote Linux Device in the pull-down menu of the Add button.

See also How To: Develop for remote Linux, Debug remotely with GDB, Developing for Remote Linux Devices, and Remote Linux Deploy Configuration.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.