You must have a recent version of Docker Engine installed
Docker disk image size must be increased to 120GB (from the default of 60GB) to install the full Rosette Enterprise package.
If installing on Windows, Docker for Windows must be installed (not Docker Toolbox or Docker Machine) with Hyper-V enabled.
The Docker memory must be set to at least 16 GB if all endpoints are licensed and activated, and may require more depending on your application.
At a minimum, the Docker maximum memory should be the same or more than the Rosette JVM heap size. Otherwise, when running in a Docker container Rosette Enterprise may get SIGKILL when the JVM asks for more memory the Docker allocates.
Once the Rosette files are downloaded and installed, Docker can be run without being connected to the internet. To install offline:
Download the component file tarballs, along with the Docker files and license, from the email containing the Rosette Enterprise files.
import_docker_images.sh to create the Docker volumes.
Run the Docker container (
docker-compose) as described below.
Install and Run Docker Container
To download the volumes directly, you must have an internet connection.
Download the Docker file
docker-compose.yaml and license file
rosette-license.xml. Note the location of the license file (path-to-license).
To run the Docker container (and download the volumes if they haven't already been downloaded):
ROSAPI_LICENSE_PATH=<path-to-license>/rosette-license.xml docker-compose up
You can also provide a stack name:
-p <stack-name> up
The Rosette RESTful server will be accessible on the Docker host on the port defined in the
If your installation includes the entity extraction component (
rex-root), you may see
failed to open ... warning messages for data files in languages not installed in your system. These can safely be ignored.
Modifying Rosette Parameters in Docker
To modify Rosette parameters, edit the
The following configuration options can be changed by editing the environment section of the file.
Uncomment the line for the variable and change the value.
To run the entity extraction and linking, sentiment analysis, and topic extraction endpoints, the recommended value for ROSETTE_JVM_MAX_HEAP is 16GB. The default value in the file is 4 GB.
# - ROSETTE_JVM_MAX_HEAP=4 # max Java heap size in GB, default is 4, must be >=4;
# to run all endpoints the recommended minimum is 16
# - ROSETTE_WORKER_THREADS=2 # number of worker threads, default is 2, must be >=1
# - ROSETTE_PRE_WARM=false # pre-warm the server on startup, default is false,
# valid values are true|false
# - ROSETTE_DOC_HOST_PORT=localhost:8181 # hostname should be accessible on the network,
# port value should match mapped port above
You can specify your own volume, for example, backed by a different volume driver.
# if a local volume is not desirable, change this to suit your needs
The default docker configuration uses port 8181 for the Rosette endpoints. To change this, modify the ports section.
Only the first value in the port statement should be changed. The port statement and the
ROSETTE_DOC_HOST_PORT value must match.
If you're accessing the documentation from a different machine, change local host to the documentation machine network accessible host name.