Prerequisites
Before you begin, make sure you have the following:- An organization on Anaconda.com with a current subscription.
- A Linux server that meets the system requirements.
Installing JupyterHub
1
Download and unpack the installer
- Log in to your Linux server as a root user.
-
Download the installer by running the following command:
-
Unpack the installer tarball:
Example
2
Gather your SSL/TLS certificate information
Locate your SSL/TLS The
.crt
and .key
files and note their paths for later use.If you don’t have valid SSL/TLS certificates, you can proceed by using the DIY-SSL-CA
package (included with the installer):The self-signed certificates created by the
DIY-SSL-CA
package can reduce your time to first use of JupyterHub, but should be replaced with valid certificates from a trusted certificate authority as soon as possible. Do not use self-signed certificates in production environments!create_noprompt.sh
script generates the files that you’ll reference later as environment variables at the following directory locations:DIY-SSL-CA/CA/ca.crt
DIY-SSL-CA/out/<HOSTNAME>/<HOSTNAME>-bundle.crt
DIY-SSL-CA/out/<HOSTNAME>/<HOSTNAME>.key
<HOSTNAME>
is your JupyterHub server hostname.3
Create a service account
Create a dedicated service account for the JupyterHub services to use to authenticate to your organization members.
- Sign in to Anaconda.com.
- Navigate to your Organizations page.
- Select the organization you want to create a service account for.
- Under User Management, select Service Accounts.
- Click Add Account.
- Name for your service account JupyterHub.
- Click Save.
- Save the Client ID and Client Secret in a secure location.
4
Add your OAuth callback URL
Submit a request to add your OAuth callback URL to the JupyterHub service account. Complete the request form as follows:
- Enter your email address.
- Enter “JupyterHub OAuth callback URL” as the subject.
-
In the description, provide your JupyterHub server’s fully qualified domain name.
If you have modified your
jupyterhub_config.py
’s config class variable (c.AnacondaServerAuthenticator.oauth_callback_url
), include the modified value in the description. - Select All users as the user impact.
- Select Low as the priority.
- Select Package Security Manager (Cloud) as the product.
-
Enter
N/A
as the product version. - Select Production as the system type.
- Select Integration as the ticket type.
- Select Submit.
You will receive an email when your request is approved. You can continue with the installation process while you wait for the request to be approved, but users will not be able to log into the JupyterHub server until your request is approved.
5
Create an environment file
Create an environment file named Add the following environment variables to the
.env
in your /home/<username>/
directory.If you already have an
.env
file in your home directory, you can name your new file something else, like .env_jhub_anaconda
..env
file you just created, and populate them with the values you gathered in the previous steps:The
REPO_CHANNELS
variable is a list of that the JupyterHub services will use to install when users build new in Jupyter. The installer configures conda to respect the priority of the channels in the order they are listed in the environment file.6
Run the installer
Run the installation command:
I am receiving a libcrypt.so.1
error post installation
Amazon Linux does not include libxcrypt-compat
, which causes nginx services to error when starting.
If you receive a libcrypt.so.1
error post installation, install the libxcrypt-compat
package on your JupyterHub server: