// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page creator-run-settings-remote-linux.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-remote-linux

    \title Specify remote Linux run settings

    To specify run settings for the selected \l{Managing kits}{kit}, go to
    \uicontrol Projects > \uicontrol {Run Settings}.

    To run and debug an application on a Linux-based device, you must create
    connections from the development host to the device and add the device
    configurations to kits. Select \uicontrol {Manage Kits} to add devices
    to kits.

    When you run the application, \QC copies the files to the connected device.

    The run settings display the path to the
    executable file on the development host and on the device. To specify that
    another application launches your application, for example, enter the
    command in the \uicontrol {Alternate executable on device} field and select
    \uicontrol {Use this command instead}.

    \image {qtcreator-run-settings-remote-linux.webp} {Run settings for Linux-based devices}

    You can specify arguments to pass to your application in the
    \uicontrol {Command line arguments} field.

    To disable library linking for the current project, clear
    \uicontrol {Add build library search path to PATH}. For more information,
    see \l {Linker libraries}.

    \section1 View the application UI

    Select \uicontrol {Use X11 forwarding} to show a remotely
    running X11 client on a local display.

    Select \uicontrol {Use the Qt VNC platform for display} to render the
    application using the Qt VNC platform plugin. \QC sets the
    \c {QT_QPA_PLATFORM=vnc} environment variable for the application.
    To connect to the application UI with a VNC client, check the
    \uicontrol {Application Output} view for the IP address and port.

    \include {creator-projects-settings-run-desktop.qdoc} {run-as-user}

    \sa {Activate kits for a project}, {Configure projects for running},
    {Remote Linux}{How to: Develop for remote Linux},
    {Developing for remote Linux devices}, {Managing kits}
*/
