Use Stata as a Workspace

Stata® statistical software provides all the features you need for data science and inference–data manipulation, exploration, visualization, statistics, reporting, and reproducibility.

There are three versions of Stata:

Basic Edition (BE)
Standard Edition (SE)
Multiprocessor Edition (MP)

Note

Requirements

To use a Stata workspace in Domino you need a valid Stata license file. When obtaining a license from Stata, you receive the licensing info in a PDF file. You need the following data from this file:

Licensed software version (Either MP, SE, or BE.)
Serial number (12 digit number)
Code (Series of nine 4 character codes)
Authorization (4 character code)

Create a license file

Use the following steps to create a valid license file:

Open the Stata environment in Domino.
Right click on the background and select applications>shells>bash.
Go to the Stata program directory:

cd /usr/local/stata
As superuser, run the Stata init program:

sudo ./stinit
Follow the prompts to enter the serial number, code, and authorization.
Follow the additional prompts to enter the organization name and location.

Note

Completing this process generates the Stata license file stata.lic in the stata directory. Be sure to copy the contents of this file to a safe location.

Custom image path

When creating a Domino workspace environment for Stata, use the following custom base image:

quay.io/domino/stata:17

Dockerfile instructions

The environment dockerfile instructions should contain the following two Docker commands. Ensure the STATA_VERSION matches the customers' licensed version. The version should be either MP, SE, or BE.

ENV STATA_VERSION="MP"
RUN apply-license “<url_to_license_file>”

Pluggable workspace properties

Paste the following code into the environments pluggable workspace properties input box.

stata:
    title: "Stata"
    iconUrl: "https://raw.githubusercontent.com/dominodatalab/partner-resources/main/assets/workspaces/stata/statamp.png"
    start: [ "/opt/domino/workspaces/stata/start" ]
    httpProxy:
        port: 8080
        internalPath: "/{{ownerUsername}}/{{projectName}}/{{sessionPathComponent}}/{{runId}}/#/?username=domino&password=domino"
        rewrite: false
        requireSubdomain: true