Getting Started
This is the official OpenTAP documentation for users and developers.
What is OpenTAP
OpenTAP is an Open Source project for fast and easy development and execution of automated tests.
OpenTAP is built with simplicity, scalability and speed in mind, and is based on an extendable architecture that leverages .NET. OpenTAP offers a range of sequencing functionality and infrastructure that makes it possible for you to quickly develop plugins tailored for your automation needs – plugins that can be shared with the OpenTAP community through the OpenTAP package repository.
Learn more about OpenTAP here.
We recommend that you download the Developer's System provided by Keysight Technologies available with a commercial or community license. The Developer's System is a bundle that contains the SDK as well as a graphical user interface and result-viewing capabilities.
Install OpenTAP
Windows
- Download the installer.
- Start the installer.
Linux
Note: Dotnet installed using Snap is NOT supported. The Snap permissions for dotnet does not permit it to read hidden files (files or directories starting with a '.') which breaks core functionality of OpenTAP.
Ubuntu 20.04
For Ubuntu 20.04 and up, we provide an installer similar to the windows installer.
- Download the installer.
- Make the installer executable:
chmod +x path-to-installer
- Start the installer.
The installer supports the --quiet
flag which can be used to install OpenTAP in scripts, or in a terminal environemnt:
# Download the latest OpenTAP release
curl -Lo opentap.linux https://packages.opentap.io/4.0/Objects/www/OpenTAP?os=Linux
# Make it executable
chmod +x ./opentap.linux
# Run the installer
sudo ./opentap.linux --quiet
The installer is likely to work on other Linux distributions, but additional dependencies may be required on these platforms, such as dotnet 6 runtime.
Other Linux distributions
For other Linux distributions, OpenTAP can be installed using the terminal:
- Install dotnet: Instructions.
- For Ubuntu:
sudo apt install -y dotnet-sdk-8.0
.
- For Ubuntu:
- Download the latest OpenTAP release:
curl -Lo opentap.zip 'https://packages.opentap.io/4.0/Objects/Packages/OpenTAP?os=Linux&architecture=<architecture>'
.- Remember to change the architecture if needed (
x64
,arm64
,arm
).
- Remember to change the architecture if needed (
- Create a directory for OpenTAP:
mkdir -p /home/$USER/.local/share/opentap
. - Extract the OpenTAP release:
unzip ./opentap.zip -d /home/$USER/.local/share/opentap
.- If you don't have unzip installed, you can install it with
sudo apt install unzip
.
- If you don't have unzip installed, you can install it with
- Make tap executable:
chmod +x /home/$USER/.local/share/opentap/tap
. - Add installation dir to PATH by adding the following line to your terminal read config file:
- For bash:
echo 'export PATH=/home/$USER/.local/share/opentap/:$PATH' >> ~/.bashrc
. - For zsh:
echo 'export PATH=/home/$USER/.local/share/opentap/:$PATH' >> ~/.zshrc
.
- For bash:
- Reload the terminal:
- For bash:
source ~/.bashrc
orexec bash
. - For zsh:
source ~/.zshrc
orexec zsh
.
- For bash:
An example using Ubuntu 24.04
This example shows how to install OpenTAP on ARM64 Ubuntu 24.04 running on a Raspberry PI 5. The steps are similar for other distributions.
# Install dotnet and unzip
sudo apt install -y dotnet-sdk-8.0 unzip
# Download the latest OpenTAP release
curl -Lo opentap.zip 'https://packages.opentap.io/4.0/Objects/Packages/OpenTAP?os=Linux&architecture=arm64'
# Create a directory for OpenTAP
mkdir -p /home/$USER/.local/share/opentap
# Extract the OpenTAP release
unzip ./opentap.zip -d /home/$USER/.local/share/opentap
# Make tap executable
chmod +x /home/$USER/.local/share/opentap/tap
# Add installation dir to PATH
echo 'export PATH=/home/$USER/.local/share/opentap/:$PATH' >> ~/.bashrc
# Reload your bash config
source ~/.bashrc
MacOS
There is no installer available on Mac. Instead, OpenTAP must be installed using the terminal:
# Download the latest OpenTAP release
curl -Lo opentap.zip 'https://packages.opentap.io/4.0/Objects/Packages/OpenTAP?os=MacOS&architecture=arm64'
# Extract it wherever you would like the installation to be
unzip ./opentap.zip -d opentap
# Make tap executable
chmod +x ./opentap/tap
OpenTAP requires dotnet 6 runtime. If you do not already have dotnet installed, get it from Microsoft.
Verify the installation works by trying for example ./opentap/tap package list --installed
.
Docker
We also provide docker images for running OpenTAP. You can find them at hub.docker.com/r/opentapio/opentap.
We maintain two images:
- a development image which includes all necessary tools to build OpenTAP projects (~2.5GB)
- a production image which includes only dependencies required to run OpenTAP (~330MB)
The development image is widely used for building and packaging plugins in highly reproducible environments, and we use it internally for continuous deployment. Have a look at the Demonstration plugin's gitlab CI file where we build, test, version, and publish the plugin directly in a continuous integration pipeline.
Where to go next
Are you already an OpenTAP user, or want to try it out? Have a look at the User Guide.
Are you a developer and want to create plugins for OpenTAP? Have a look at the Developer Guide.