WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

RemoteRunProcess
✖
RemoteRunProcess

Unsupported in Public Cloud[Experimental]

✖
RemoteRunProcess["host","command"]

runs the specified system command on the remote host, returning information on the outcome.

✖
RemoteRunProcess[IPAddress["address"],"command"]

runs the command on the machine with the specified IP address.

✖
RemoteRunProcess[obj,"command"]

run the command on the remote host specified by the RemoteConnectionObject obj.

✖
RemoteRunProcess["host",{"command",arg1,arg2,…}]

runs the specified command, with command-line arguments argi.

✖
RemoteRunProcess["host", command,"prop"]

returns only the specified property.

✖
RemoteRunProcess["host", command,prop,input]

feeds the specified initial input to the command.

Details and Options

  • RemoteRunProcess returns an association with the process exit code, the standard output and the standard error.
  • RemoteRunProcess["host",…] prompts for a username and password.
  • RemoteRunProcess["user@host",…] prompts for a password only.
  • RemoteRunProcess will use an ssh-agent for authentication if available.
  • In RemoteRunProcess[command,prop,input], input is automatically converted to a string using ToString. The same is true for the argi in RemoteRunProcess[{command,arg1,…},…].
  • Typical possible properties to return include:
  • "ExitCode"the exit code for the process
    "StandardOutput"data sent to standard output, as a string
    "StandardError"data sent to standard error, as a string
    Allan association of all properties (default)
  • RemoteRunProcess allows the following options:
  • Authentication $SSHAuthenticationauthentication parameters for the connection
    RemoteAuthorizationCaching Falsewhether to use remote authorization caching
  • In the form Authentication->assoc, the association assoc can contain these keys:
  • "Username"username to use for authentication
    "Password"password to use for authentication
    "SSHKey"SSH identity
    "SSHKeyPassword"passphrase string to use to decrypt SSHKey
  • An SSH identity can be given in the form "SSHKey"->File[ident], where ident is a file containing an SSH private key. It can also be given as "SSHKey"->"string", where "string" is an SSH private key.

Examples

open allclose all

Basic Examples  (1)Summary of the most common use cases

Evaluate the hostname command on a remote machine:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-fmimwx
Out[1]=1

Use a specific username to run the uptime command:

In[2]:=2
✖
https://wolfram.com/xid/0bnilorzwg50i-caxlh0
Out[2]=2

Retrieve a specified property from a command:

In[3]:=3
✖
https://wolfram.com/xid/0bnilorzwg50i-h7wtd8
Out[3]=3

Provide input to a command:

In[4]:=4
✖
https://wolfram.com/xid/0bnilorzwg50i-bncmxk
Out[4]=4

Create a persistent session with RemoteConnect:

In[5]:=5
✖
https://wolfram.com/xid/0bnilorzwg50i-zvvtd
Out[5]=5

Once the session is created, it can be used without having to reconnect:

In[6]:=6
✖
https://wolfram.com/xid/0bnilorzwg50i-fwhz8
Out[6]=6

Close the session:

In[7]:=7
✖
https://wolfram.com/xid/0bnilorzwg50i-coxsi7

Scope  (1)Survey of the scope of standard use cases

Obtain the exit code from a command:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-yex9iy
Out[1]=1

Start a process asynchronously. When it is done, read from the log:

In[2]:=2
✖
https://wolfram.com/xid/0bnilorzwg50i-by596
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0bnilorzwg50i-exl05k
Out[3]=3

Options  (4)Common values & functionality for each option

Authentication  (3)

Run a remote process using username and password authentication:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-0cpw
Out[1]=1

Run a remote process using an identity file for authentication:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-ivz5wj
Out[1]=1

Set a value for $SSHAuthentication:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-olk5bz

Now processes can be run using the default authentication contained in $SSHAuthentication:

In[2]:=2
✖
https://wolfram.com/xid/0bnilorzwg50i-cr4woa
Out[2]=2

RemoteAuthorizationCaching  (1)

Authorize future connections by placing the public key on the remote machine:

In[1]:=1
✖
https://wolfram.com/xid/0bnilorzwg50i-cyhxej
Out[1]=1

This user is now authorized to execute commands without authentication:

In[2]:=2
✖
https://wolfram.com/xid/0bnilorzwg50i-dkfjja
Out[2]=2
Wolfram Research (2018), RemoteRunProcess, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteRunProcess.html.
✖
Wolfram Research (2018), RemoteRunProcess, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteRunProcess.html.

Text

Wolfram Research (2018), RemoteRunProcess, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteRunProcess.html.

✖
Wolfram Research (2018), RemoteRunProcess, Wolfram Language function, https://reference.wolfram.com/language/ref/RemoteRunProcess.html.

CMS

Wolfram Language. 2018. "RemoteRunProcess." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/RemoteRunProcess.html.

✖
Wolfram Language. 2018. "RemoteRunProcess." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/RemoteRunProcess.html.

APA

Wolfram Language. (2018). RemoteRunProcess. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RemoteRunProcess.html

✖
Wolfram Language. (2018). RemoteRunProcess. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/RemoteRunProcess.html

BibTeX

@misc{reference.wolfram_2025_remoterunprocess, author="Wolfram Research", title="{RemoteRunProcess}", year="2018", howpublished="\url{https://reference.wolfram.com/language/ref/RemoteRunProcess.html}", note=[Accessed: 08-July-2025 ]}

✖
@misc{reference.wolfram_2025_remoterunprocess, author="Wolfram Research", title="{RemoteRunProcess}", year="2018", howpublished="\url{https://reference.wolfram.com/language/ref/RemoteRunProcess.html}", note=[Accessed: 08-July-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_remoterunprocess, organization={Wolfram Research}, title={RemoteRunProcess}, year={2018}, url={https://reference.wolfram.com/language/ref/RemoteRunProcess.html}, note=[Accessed: 08-July-2025 ]}

✖
@online{reference.wolfram_2025_remoterunprocess, organization={Wolfram Research}, title={RemoteRunProcess}, year={2018}, url={https://reference.wolfram.com/language/ref/RemoteRunProcess.html}, note=[Accessed: 08-July-2025 ]}