Dash Enterprise Administration
4.3.1
4.3.1
  • Changelog
  • Installation
    • Capacity Planning
      • Dash Enterprise Single Server
      • Dash Enterprise for Kubernetes
    • Before you install
    • Dash Enterprise Single Server
      • Installation on cloud provider
      • On-premise installation on own server
      • Fully offline installation
    • Dash Enterprise Kubernetes
      • Amazon Web Services resource prerequisites
      • Google Cloud Platform resource prerequisites
      • Microsoft Azure resource prerequisites
  • Configuration
    • Set up your Server Manager
    • Run preflight checks
    • Configure basic settings
    • Authentication settings
      • Built-in local authentication
      • LDAP authentication
      • SAML authentication
    • Dash Enterprise Kubernetes additional required configuration
    • Configure optional settings
    • Add SELinux permissions to mapped directories
    • Other options and customizations
    • Using Snapshots & Backups
    • Running and logging into Dash Enterprise
    • Next steps
  • Advanced Configuration
    • General troubleshooting and problem solving
      • Dash Enterprise Kubernetes
    • Load balancer configuration
    • Reverse proxy setup instructions
    • Docker storage driver requirements and considerations
    • Import an LDAPS certificate from Active Directory into Dash Enterprise
    • Transfer Dash Enterprise to a new server
    • Sync license changes
    • Change channels for an upgrade
    • Admin panel reference
    • Configure Dash Enterprise to use common SAML IdPs
      • Active Directory Federation Services (AD FS)
      • PingFederate
      • Okta
    • Configure Dash Enterprise to use common LDAP IdPs
      • Okta
  • Upgrade
    • Prepare for the upgrade
    • Upgrade
      • Dash Enterprise Single Server
      • Dash Enterprise for Kubernetes
    • After the upgrade
  • Advanced Troubleshooting
    • Dash Enterprise Architecture and Internals
    • Navigating the System
    • Navigating the Support Bundle
    • Getting Help and Reporting Issues
    • Troubleshooting Specific Issues
Powered by GitBook
On this page
  • Dash app limitations in offline mode
  • Prepare the environment
  • Install Docker
  • Additional Docker setup for CentOS 7/RHEL 7 systems
  • Install the Server Manager
  • Create the Plotly data directory
  • Download, rename and copy the installation package
  • Install
  • Installing Dash Enterprise packages

Was this helpful?

  1. Installation
  2. Dash Enterprise Single Server

Fully offline installation

PreviousOn-premise installation on own serverNextDash Enterprise Kubernetes

Last updated 1 year ago

Was this helpful?

This section applies to installing Dash Enterprise on a single server in a fully offline environment.

Dash Enterprise supports fully offline installations (a.k.a. airgapped installations), with some limitations in deploying Dash apps (described in )).

Apart from Internet access, the server requirements for a fully offline installation are the same as for a normal installation on your own hardware, as well as:

  1. A supported version of Docker and the Server Manager installed on your server (described )

  2. A link to the Dash Enterprise airgapped installation package, provided to you by the Plotly sales team

Dash app limitations in offline mode

These are currently known limitations with how Dash apps work offline and may be addressed in a future Dash Enterprise release:

  • All Python packages, including Dash libraries and their dependencies, must be available via a private PyPI repository specified in the app’s requirements.txt.

  • All Python dependencies must be installed via requirements.txt or via Conda.

    • Pipfile and nltk.txt are not supported.

  • Only Conda runtimes Miniconda2-4.5.12 and Miniconda3-4.5.12 are supported.

    • If an unsupported version is listed in your conda-runtime.txt, the app build will hang or fail.

  • hg+ and git+ requirements are not supported.

Prepare the environment

Install Docker

CentOS/RHEL systems have some dependencies for installing Docker. You will typically need the following packages:

  • container-selinux-2.107-3.el7.noarch.rpm

  • containerd.io-1.6.9-3.1.el7.x86_64.rpm

  • docker-ce-cli-20.10.21-3.el7.x86_64.rpm

  • docker-ce-20.10.21-3.el7.x86_64.rpm

  1. Download the correct Docker package for your needs, plus any dependencies, and transfer those files to your server

    1. If the server has access to a local yum or apt repository, you can use yum or apt to install dependencies from that repository instead of manually installing them

  2. Install Docker using one of the following commands:

sudo dpkg --install <package_name>.deb
sudo rpm -ivh <package_name>.rpm

Additional Docker setup for CentOS 7/RHEL 7 systems

After installing Docker, increase the default devicemapper base device size as follows:

  • Add the following line to /etc/default/docker:

DOCKER_OPTS=--storage-opt dm.basesize=20G

If an uncommented DOCKER_OPTS line already exists, append the following string to it instead of adding a new line: --storage-opt dm.basesize=20G

  • Restart Docker

sudo service docker restart
sudo systemctl restart docker

Install the Server Manager

The Server Manager is a web-based console where you can manage your Dash Enterprise instance’s settings, as well as perform upgrades and start/stop the application. This component is normally installed automatically when using an online installation process, but when working offline, must be installed separately as follows:

  1. In a terminal, run the following commands:

tar xzvf replicated-*.tar.gz
cat ./install.sh | sudo bash -s airgap

Create the Plotly data directory

This directory will hold all of the Dash Enterprise data, such as configuration, apps, databases, logs, and other files. You can name this directory anything, but we recommend /plotly for consistency with other installation types and the rest of this documentation.

sudo mkdir /plotly

Download, rename and copy the installation package

  1. Use the download link and password provided to you by Plotly to download an airgap installation package. Set the --trust-server-names flag for wget. Alternatively, rename the file to something ending with .airgap.

  2. Copy the package to your server and note the path you copied it to.

Install

  • Browse to the Server Manager on port 8800 of your base domain.

You will see an untrusted connection warning; this is expected and not a reason for concern

  • Accept the initial self-signed certificate and enter the Hostname of your server.

    • If you have a CA-issued TLS/SSL certificate and the corresponding key, select them here and choose Upload & Continue.

    • Otherwise, choose Use Self-Signed Cert and accept the new certificate generated.

  • Choose Airgapped as the installation type and click Continue.

Your server is now ready to be configured.

Installing Dash Enterprise packages

PLOTLY_DASH_DOMAIN_BASE is the Dash Enterprise server’s DNS name. Additional consideration is often needed on airgapped environments to reach the packages hosted at this endpoint. If PLOTLY_DASH_DOMAIN_BASE is configured to be the public IP of the host and if this IP is unreachable from the host itself, we have identified two workarounds:

  1. Change the Dash Domain DNS entry to the private IP of the host, then use a proxy server to reach your host from a browser; or

  2. Download any needed packages from https://PLOTLY_DASH_DOMAIN_BASE/Docs/packages/ and transfer them to an internal Python package repository that can be reached from your instance.

Dash Enterprise is compatible with Docker versions up to 22.X.X. For help choosing an appropriate Docker version, see .

If you need to use a different operating system and/or Docker version, please for assistance.

On an Internet-capable machine, download the latest Server Manager release from and transfer it to your destination server.

Once installed, the Server Manager is available on port 8800 of your server’s IP or base domain (e.g. or [https://plotly.your-company.com:8800](https://plotly.your-company.com:8800%29).

Click Choose License and select the license (.rli) file provided to you by the .

Enter the full path to the airgap package file you copied and click Continue.

The images used to build Dash applications on the Dash Enterprise server are configured to install Plotly-hosted Dash dependencies, such as , via an internal repository located at https://PLOTLY_DASH_DOMAIN_BASE/Docs/packages/.

contact Plotly support
https://s3.amazonaws.com/replicated-airgap-work/stable/replicated-2.53.5%2B2.53.5%2B2.53.5.tar.gz
https://12.34.56.789:8800
Plotly sales team
Dash Design Kit
Dash app limitations in offline mode
here
here
Docker requirements for running Dash Enterprise