RemoteRunProcess
✖
RemoteRunProcess
runs the specified system command on the remote host, returning information on the outcome.
runs the command on the machine with the specified IP address.
run the command on the remote host specified by the RemoteConnectionObject obj.
runs the specified command, with command-line arguments argi.
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 All an association of all properties (default) - RemoteRunProcess allows the following options:
-
Authentication $SSHAuthentication authentication parameters for the connection RemoteAuthorizationCaching False whether 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 allBasic Examples (1)Summary of the most common use cases
Evaluate the hostname command on a remote machine:

https://wolfram.com/xid/0bnilorzwg50i-fmimwx

Use a specific username to run the uptime command:

https://wolfram.com/xid/0bnilorzwg50i-caxlh0

Retrieve a specified property from a command:

https://wolfram.com/xid/0bnilorzwg50i-h7wtd8


https://wolfram.com/xid/0bnilorzwg50i-bncmxk

Create a persistent session with RemoteConnect:

https://wolfram.com/xid/0bnilorzwg50i-zvvtd

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

https://wolfram.com/xid/0bnilorzwg50i-fwhz8


https://wolfram.com/xid/0bnilorzwg50i-coxsi7
Scope (1)Survey of the scope of standard use cases
Options (4)Common values & functionality for each option
Authentication (3)
Run a remote process using username and password authentication:

https://wolfram.com/xid/0bnilorzwg50i-0cpw

Run a remote process using an identity file for authentication:

https://wolfram.com/xid/0bnilorzwg50i-ivz5wj

Set a value for $SSHAuthentication:

https://wolfram.com/xid/0bnilorzwg50i-olk5bz
Now processes can be run using the default authentication contained in $SSHAuthentication:

https://wolfram.com/xid/0bnilorzwg50i-cr4woa

RemoteAuthorizationCaching (1)
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
]}
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
]}