Local Onebox Installation


Onebox enables users to experience Fiddler’s leading explanations, analytics, and monitoring capabilities by running Fiddler locally using their own models and data (or the included samples).


Time: 10 mins




If you are using a Mac to run Onebox, make sure to allocate the maximum (or at least 4GB) memory reserved for docker (via Docker Icon > Preferences > Advanced > Memory)

  • Mac or Linux. MacOS Sierra 10.12 or newer is supported
  • To install Onebox on AWS EC2 or similar VMs, Make sure you read the onebox requirements section below


1.Download Onebox
Click on the time-sensitive download link included in the email with the included credentials to download fiddler-onebox-1.x.xx.tar.gz. This is a large 4GB+ size file.

Alternatively, you can download from the command line:

curl --output fiddler-1.x.xx.tar.gz https://s3-us-xxxx-x.amazonaws.com/fiddler.ai/download/fiddler-1.x.xx-5743889dc.tar.gz

2.Untar (replace with latest file name):

tar zxvf fiddler-1.x.xx-edXNtP4SAe8FvxKp.tar.gz
  • Note: The download link will expire automatically after a period of time (30, 60, or 90 days. depending on the license).

    3.Run Onebox

  • Loads fiddler images into docker. Note: Make sure Docker is running

Starts fiddler containers. The output will look like:

Starting Fiddler
Fiddler hosted at: http://localhost:4100

4.Optionally, the service can support HTTPS access over port 443. This can be enabled by providing appropriate TLS certificate during startup:

Directory Structure

Under the fiddler directory, you’ll see a repo directory containing the onebox directory. The onebox directory contains project directories (e.g. bank_churn, iris_classification, lending). It also contains dataset directories, found within datasets (e.g. p2p_loans, winequality).


   $ cd samples
   $ ./deploy

Fiddler Onebox comes with pre-loaded samples. If samples don't exist, then run the above command to imports all dataset and models to Fiddler

Accessing the UI

You can access the Fiddler UI locally with Onebox using http://localhost:4100.

You will be prompted to log in. Use the following credentials:

  • Username: [email protected]
  • Default password: xai/4u
    * You can change the password in Settings → General.

Once user logs into fiddler, a home page appears as seen in the below screenshot.

For the next steps in the onboarding, visit our Quick Start guide to get started.


If you’re upgrading from an older Onebox solution and you want to transfer all your data and model changes to the new version, follow these steps:

  1. Copy your local fiddler folder to a new folder called fiddler-backup.
  2. Follow the steps in the Setup section above to install the latest version of Onebox.
  3. Copy the license.key file from your new fiddler/repo/onebox/common folder and put it in a safe place.
  4. Delete the repo and data directories from your new fiddler directory.
  5. Copy the repo and data directories from your fiddler-backup directory into your new fiddler directory.
  6. Replace the license.key file in your repo/onebox/common folder with the copy that you saved in step 3.
  7. (Optional) If you want to save space, you can delete the fiddler-backup directory.

Systems requirements

  • Image - Linux (Supported distro: Amazon AMI HVM, Ubuntu, Centos, RHEL, Mac OS)
  • Compute - 8 cores, 32GB or larger machines
  • Storage - min. 128GB
  • Port - 4100 or 443 (HTTPS support on port 443)
    - Internally uses 5100, 6100, 27017, 5432, 4369
  • Docker - min. Docker ver 19+



If you are using a Mac to run Onebox, make sure to allocate the maximum (or at least 4GB) memory reserved for docker (via Docker Icon > Preferences > Advanced > Memory)

Supporting packages

  • Linux 64bits with docker support
  • bash for scripts
  • nc (net cat) for establishing command line tcp connection
  • curl
  • internet connection for pip install packages

Server Setup

Please run the following commands or equivalent depending on where Fiddler is running. These instructions are for an AWS EC2 instance.

Once the EC2 instance is successfully started, SSH into the machine.

ssh -i "../deploy/secret/fiddler-service.pem" \
   [email protected]<--ipaddress-->.<region>.compute.amazonaws.com

Perform the yum update, followed by installing docker and adding your user to the docker group:

sudo yum update -y
sudo amazon-linux-extras install docker
sudo service docker start
sudo usermod -a -G docker ec2-user

Next, install nc

sudo yum install nc

Log out and SSH into the machine again, then run the following commands:

docker info
docker images

[^1]: Join our community Slack to ask any questions

Did this page help you?