Skip to main content

Python Remote Server for Robot Framework

Project description


Robot Framework remote servers allow hosting test libraries on different processes or machines than Robot Framework itself is running on. This version is implemented in Python and supports also Jython (JVM) and IronPython (.NET). See remote library interface documentation for more information about the remote interface in general as well as for a list of remote server implementations in other programming languages.

This project is hosted in GitHub and downloads are available in PyPI.


The easiest installation approach is using pip:

$ pip install robotremoteserver

Alternatively you can download the source distribution, extract it, and install it using:

$ python install


The remote server can be started by simply creating an instance of the server and passing a test library instance or module to it:

from robotremoteserver import RobotRemoteServer
from mylibrary import MyLibrary


By default the server listens to address and port 8270. See the next section for information about configuring the server.


The remote server accepts following configuration parameters:






Address to listen. Use '' to listen to all available interfaces.



Port to listen. Use 0 to select a free port automatically.



File to write port that is used.



Allow/disallow stopping the server using Stop Remote Server keyword.

Address and port that are used are printed to the console where the server is started. Writing port to a file by using port_file argument is especially useful when the server selects a free port automatically. Other tools can then easily read the active port from the file. If the file is removed prior to starting the server, tools can also wait until the file exists to know that the server is up and running.


from robotremoteserver import RobotRemoteServer
from mylibrary import MyLibrary

RobotRemoteServer(MyLibrary(), host='', port=0,
                  port_file='/tmp/remote-port.txt', allow_stop=False)


The remote server can be gracefully stopped using three different methods:

  • Hitting Ctrl-C on the console where the server is running.

  • Sending the process SIGINT, SIGTERM, or SIGHUP signal.

  • Using Stop Remote Server keyword (unless explicitly disabled).


The remote server project contains an example that can be studied and also executed once the library is installed. The example is also included in the source distribution.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robotremoteserver-1.0.tar.gz (10.7 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page