---
name: "x2goruncommand"
section: "8"
platform: "linux"
package: "x2goserver"
version: "4.1.0.6-1.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/x2goruncommand"
---

# x2goruncommand(8)

Launch Command inside an X2Go Session

## NAME

x2goruncommand - Launch Command inside an X2Go Session

## SYNOPSIS

x2goruncommand \<display\> \<agent\_pid\> \<session\_id\> \<command\> \<sound\_system\> \<session\_type\>

## DESCRIPTION

**x2goruncommand** launches a(n X-based) command inside of a given X2Go session.

**x2goruncommand** is run with X2Go user privileges and normally executed by an X2Go client application.

## ARGUMENTS

- FC**\<display\>**F\[0\]

  The X display number/port of the session this command is for.

- FC**\<agent\_pid\>**F\[0\]

  The process ID (pid) of the x2goagent instance that the given session runs in.

- FC**\<session\_id\>**F\[0\]

  The \<session\_id\> is the unique identifier of the X2Go session that this command is intended for.

- FC**\<command\>**F\[0\]

  Execute command \<command\>. Full paths will be ignored, the command has to be in the server's $PATH.

  Possible generic values for \<command\> are: WWWBROWSER, OFFICE, MAILCLIENT and TERMINAL.

- FC**\<sound\_system\>**F\[0\]

  Either of the possible sound systems supported by X2Go: pulse, esd, arts (obsolete) or none.

- FC**\<session\_type\>**F\[0\]

  Allowed values for \<session\_type\> are: D (desktop) and R (rootless).

## RETURN VALUES

By **x2goruncommand** nothing is reported on stdout or stderr.

As exitcode **x2goruncommand** always returns 0.

## SEE ALSO

[x2gostartagent(8)](/x2gostartagent/8.md), [x2goresume-session(8)](/x2goresume-session/8.md), [x2gosuspend-session(8)](/x2gosuspend-session/8.md), x2goterminate-sessions(8)

## AUTHOR

This manual has been written by Mike Gabriel \<mike.gabriel@das-netzwerkteam.de\> for the X2Go project (https://www.x2go.org).
