Skip to main content

Download and Import

Transcription:BatchReal-TimeDeployments:Virtual Appliance

Downloading the Appliance

A download link will be provided by Speechmatics through the knowledgebase section of the Support Portal. The latest version of the Appliance can be located within the knowledgebase. Select the required version number within the "Batch Virtual Appliance" or "Real-Time Virtual Appliance" area that you wish to download. You can then view the download link and all associated documentation for the Virtual Appliance. Once the download link is selected the download will begin, or a save file prompt will appear, enabling the file to be saved (the exact method will depend on the web browser being used). After the download a file with an ".ova" extension will be stored on the computer.

An account is required to access the documents and download link in the Support Portal. If an account is not available or the relevant Virtual Appliance section is not visible in the Support Portal, please contact Speechmatics Support for help.

Importing the Appliance

Once the .ova file has been downloaded, it is ready to be imported into the host you have already prepared. Please ensure that the host meets the System Requirements, then based on the hypervisor environment follow the instructions below.

Note on Performance Benefits on VMWare and VirtualBox

To take advantage of Speechmatics improvements in performance using AVX2, the hardware_version of the Appliance has been upgraded from 9 to 11. If you are running VMWare ESXi host 6.5 or later, this should not affect any system behaviour. If you are on an earlier version, you can downgrade the hardware version as documented here; however please note that this will mean you cannot take advantage of more recent optimisations in performance from using Advanced Vector Extensions 2 (AVX2).

To enable AVX2 instructions in VirtualBox if automatically disabled during the import process, please follow the below instructions:

VBoxManage setextradata "$Virtual_Appliance_Name" VBoxInternal/CPUM/IsaExts/AVX2 1

VMware ESXi

The following steps can be used to import the Virtual Appliance into VMWare ESXi 6.5:

  • Open the vSphere web console on the host
  • Choose "Virtual Machines" from the Navigator
  • Select "Create/Register VM" option
  • A wizard will appear:
    • Choose "Deploy a virtual machine from an OVF or OVA file" and click "Next"
    • Enter a VM name e.g. "SM_Batch_01", and drag the downloaded .ova file onto the window and click "Next"
    • Select a datastore that has enough capacity to store the Virtual Appliance and click "Next"
    • From the "VM network" dropdown box, select a network
    • Choose Thin or Thick disk provisioning (the Speechmatics Virtual Appliance supports either). Choose the options that is right for the hosting environment refer to VMWare documentation for help and click "Next"
    • Check the details are correct and click "Finish"
  • The Virtual Appliance will import. This can take a few minutes depending on the datastore chosen.

Once the VM has imported it should be visible on the vSphere web console: Web console

Important Notice

If you are running VMWare ESXi version 6.5 version or above, change the hardware_version of the appliance to 11 to take advantage of recently implemented Speechmatics performance improvements. How to do so is documented here

VMware Workstation Player

  • Open VMware Workstation Player
  • From the top options bar select "Player", then "File" and "Open..."
  • The "Open Virtual Machine" window will appear. Navigate to the ".ova" file you downloaded earlier, select it, click "Open"
  • Enter a VM name e.g. "SM_Batch_01"
  • A default storage location for the Virtual Appliance will be shown, this can be changed if required. Click "Import".
  • Dropdown box from the top options bar, click on "File"
  • The Virtual Appliance will import. This can take a few minutes depending on the hard disk chosen

Once the VM has imported it should be visible on the Workstation player: Workstation player


The following steps can be used to import the Virtual Appliance into VirtualBox 5.2 or above.

  • Open VirtualBox
  • From the Manager window select "File", then "Import Appliance..."
  • In the Name field, name the Virtual Appliance e.g. "SM_Batch_01"
  • Browse to the OVA file and click on the "Import" button

Once the VM has imported it should be visible on the VirtualBox Manager: Virtualbox manager

Amazon Web Services

This section explains how to create a Virtual Appliance EC2 instance on the Amazon Web Services (AWS) platform by using the AWS VM Import/Export tool. This tool is designed for importing VM images from the OVA file format provided by Speechmatics. You will import the image as an Amazon Machine Image (AMI), from which you can then launch machine instances.

The information in this section is taken from the official AWS documentation and parts of it have been extracted to focus more on the particulars of the Speechmatics Virtual Appliance. For more details of the Amazon VM image import process, please refer to their documentation


There are a few prerequisites that you will need to have set up before you can follow the instructions in this section:

Please follow the recommendations on configuration of the AWS CLI by referring to the Getting Started guide.

Uploading the OVA file to S3

This section describes the process of uploading the Speechmatics OVA file to an Amazon S3 bucket from where it can be imported as an AMI instance. We recommend using a bucket in the same region where you want the AMI to be created and made available.

Once you've identified or created the S3 bucket on your account where the Speechmatics Virtual Appliance OVA will be uploaded to, you can use any of the tools below to help with the upload of the OVA file.

For more information about the multipart uploads, see the AWS documentation.

Importing the OVA as an AMI Instance

After the Virtual Appliance OVA file has been successfully uploaded to an S3 bucket, it's time to import the image.

See the AWS documentation that covers uploading an image for full details.

The steps that you will perform in this section include (in order):

  • Creating a Service Role on your AWS account
  • Assigning a Role Policy to this Service Role
  • Importing the OVA for the Virtual Appliance from the S3 bucket file

Creating an Import Service Role

First of all, a service role needs to be created on your AWS account. This allows certain operations, including downloading images from an S3 bucket.

Create a file named trust-policy.json with the following policy:

  "Version": "2012-10-17",
  "Statement": [
      "Effect": "Allow",
      "Principal": { "Service": "" },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "sts:Externalid": "vmimport"

Then use the create-role command from the AWS CLI to create a role named vmimport. You need to specify the full path of the trust-policy.json file:

aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json

You need to ensure the that file:// prefix is prepended to the filename.

Creating a Role Policy

Create a file named role-policy.json with the following policy. Where you see ova-bucket it will need to be replaced with the name of the S3 bucket where the OVA file is stored.

  "Version": "2012-10-17",
  "Statement": [
      "Effect": "Allow",
      "Action": ["s3:GetBucketLocation", "s3:GetObject", "s3:ListBucket"],
      "Resource": ["arn:aws:s3:::ova-bucket", "arn:aws:s3:::ova-bucket/*"]
      "Effect": "Allow",
      "Action": [
      "Resource": "*"

Use the put-role-policy command to attach the policy to the role. You must specify the full path to the location of the role-policy.json:

aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.json

Importing the OVA

Importing the Virtual Appliance image (OVA) to Amazon EC2 as an Amazon Machine Image (AMI) is the next step.

Create a file named containers.json with the following content. Where you see ova-bucket it will need to be replaced with the name of the S3 bucket where the OVA file is stored and where you see example-virtual-appliance.ova it will need to be replaced with the name of the OVA file to be imported (e.g. batch-appliance-<version>-maxi-<build-number>.ova or rt-appliance-<version>-maxi-<build-number>.ova).

    "Description": "Virtual Appliance OVA",
    "Format": "ova",
    "UserBucket": {
      "S3Bucket": "ova-bucket",
      "S3Key": "example-virtual-appliance.ova"

Use the import-image command to create an import task (Specify the full path to the location of the containers.json):

aws ec2 import-image --description "Virtual Appliance OVA" --disk-containers file://containers.json

The resulting JSON output will show an ImportTaskId which you can use to check the status of the import task. You do this by running the describe-import-image-tasks command:

aws ec2 describe-import-image-tasks --import-task-ids import-ami-abcd1234

You need to replace the task identifier with the ImportTaskId for your import task (import-ami-abcd1234 in this example).

When the status is in the completed state the AMI is ready to use.


For more background on creating security groups refer to the official AWS documentation. See the Ports and Protocols section for a list of the ports that are used. These ports should be opened so that you can submit jobs and manage and monitor the Speechmatics Virtual Appliance.

Real-Time Virtual Appliance

If you set up HTTPS as described in SSL Configuration then you only need to expose port 443, unless you require use of the v1 WebSocket API, which requires use of port 9000. We recommend use of our updated v2 API unless you are a customer who has already implemented code against our v1 API.

Batch Virtual Appliance

If you set up HTTPS as described in SSL Configuration then you only need to expose port 443.

Launching a Virtual Appliance

Now that the Virtual Appliance has been imported, it will be available as an AMI which can be launched as an instance. To launch a Speechmatics Virtual Appliance, do the following:

  • Login to the AWS console and find your image under EC2 Service | Images
  • Right-click the image and choose Launch
  • Refer to the System Requirements section of the Speechmatics Quick Start Guide or Admin Guide to identify how much system resources is required for your setup. Choose the instance type that meets your requirements
  • Choose Review and Launch from the console. Set up the Key Pair if required and choose Launch again

Full instructions for launching instances can be found here.