mirror of
https://github.com/jupyterhub/the-littlest-jupyterhub.git
synced 2025-12-18 21:54:05 +08:00
Merge pull request #110 from yuvipanda/install-doc-reorg
Re-organize installation documentation
This commit is contained in:
Yuvi Panda
@@ -1,29 +0,0 @@
|
||||
The **User Environment** is a conda environment that is shared by all users
|
||||
in the JupyterHub. Libraries installed in this environment are immediately
|
||||
available to all users. Admin users can install packages in this environment
|
||||
with ``sudo -E``.
|
||||
|
||||
#. Log in as an admin user and open a Terminal in your Jupyter Notebook.
|
||||
|
||||
.. image:: ../images/notebook/new-terminal-button.png
|
||||
:alt: New Terminal button under New menu
|
||||
|
||||
#. Install `gdal <https://anaconda.org/conda-forge/gdal>`_ from `conda-forge <https://conda-forge.org/>`_.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo -E conda install -c conda-forge gdal
|
||||
|
||||
The ``sudo -E`` is very important!
|
||||
|
||||
#. Install ``there`` with ``pip``
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo -E pip install there
|
||||
|
||||
The packages ``gdal`` and ``there`` are now available to all users in JupyterHub.
|
||||
If a user already had a python notebook running, they have to restart their notebook's
|
||||
kernel to make the new libraries available.
|
||||
|
||||
See :ref:`user_environment` for more information.
|
||||
@@ -1,39 +0,0 @@
|
||||
Most administration & configuration of the JupyterHub can be done from the
|
||||
web UI directly. Let's add a few users who can log in!
|
||||
|
||||
#. Open the **Control Panel** by clicking the control panel button on the top
|
||||
right of your JupyterHub.
|
||||
|
||||
.. image:: ../images/control-panel-button.png
|
||||
:alt: Control panel button in notebook, top right
|
||||
|
||||
#. In the control panel, open the **Admin** link in the top left.
|
||||
|
||||
.. image:: ../images/admin/admin-access-button.png
|
||||
:alt: Admin button in control panel, top left
|
||||
|
||||
This opens up the JupyterHub admin page, where you can add / delete users,
|
||||
start / stop peoples' servers and see who is online.
|
||||
|
||||
#. Click the **Add Users** button.
|
||||
|
||||
.. image:: ../images/admin/add-users-button.png
|
||||
:alt: Add Users button in the admin page
|
||||
|
||||
A **Add Users** dialog box opens up.
|
||||
|
||||
#. Type the names of users you want to add to this JupyterHub in the dialog box,
|
||||
one per line.
|
||||
|
||||
.. image:: ../images/admin/add-users-dialog.png
|
||||
:alt: Adding users with add users dialog
|
||||
|
||||
You can tick the **Admin** checkbox if you want to give admin rights to all
|
||||
these users too.
|
||||
|
||||
#. Click the **Add Users** button in the dialog box. Your users are now added
|
||||
to the JupyterHub! When they log in for the first time, they can set their
|
||||
password - and use it to log in again in the future.
|
||||
|
||||
Congratulations, you now have a multi user JupyterHub that you can add arbitrary
|
||||
users to!
|
||||
@@ -1,68 +0,0 @@
|
||||
.. _tutorials/custom:
|
||||
|
||||
=============================
|
||||
Installing on your own server
|
||||
=============================
|
||||
|
||||
Goal
|
||||
====
|
||||
|
||||
By the end of this tutorial, you should have a JupyterHub with some admin
|
||||
users and a user environment with packages you want installed running on
|
||||
a server you have access to.
|
||||
|
||||
Pre-requisites
|
||||
==============
|
||||
|
||||
#. Some familiarity with the command line.
|
||||
#. A server running Ubuntu 18.04 where you have root access.
|
||||
#. Ability to ``ssh`` into the server & run commands from the prompt.
|
||||
#. A **public IP** where the server can be accessed from the internet.
|
||||
|
||||
Step 1: Installing The Littlest JupyterHub
|
||||
==========================================
|
||||
|
||||
#. Using a terminal program, SSH into your server. This should give you a prompt where you can
|
||||
type commands.
|
||||
|
||||
#. Copy the text below, and paste it into the terminal. Replace
|
||||
``<admin-user-name>`` with the name of the first **admin user** for this
|
||||
JupyterHub. This admin user can log in after the JupyterHub is set up, and
|
||||
can configure it to their needs. Remember the username!
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
#!/bin/bash
|
||||
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py \
|
||||
| sudo python3 - \
|
||||
--admin <admin-user-name>
|
||||
|
||||
.. note:
|
||||
|
||||
See :ref:`topic/installer-actions` if you want to understand exactly what the installer is doing.
|
||||
:ref:`topic/customizing-installer` documents other options that can be passed to the installer.
|
||||
|
||||
#. Press ``Enter`` to start the installation process. This will take 5-10 minutes,
|
||||
and will say 'Done!' when the installation process is complete.
|
||||
|
||||
#. Copy the **Public IP** of your server, and try accessing http://<public-ip> from
|
||||
your browser. If everything went well, this should give you a JupyterHub login page.
|
||||
|
||||
.. image:: ../images/first-login.png
|
||||
:alt: JupyterHub log-in page
|
||||
|
||||
#. Login using the **admin user name** you used in step 2, and a password. Use a
|
||||
strong password & note it down somewhere, since this will be the password for
|
||||
the admin user account from now on.
|
||||
|
||||
#. Congratulations, you have a running working JupyterHub!
|
||||
|
||||
Step 2: Adding more users
|
||||
==========================
|
||||
|
||||
.. include:: add_users.txt
|
||||
|
||||
Step 3: Install conda / pip packages for all users
|
||||
==================================================
|
||||
|
||||
.. include:: add_packages.txt
|
||||
@@ -1,119 +0,0 @@
|
||||
.. _tutorial_quickstart_digitalocean:
|
||||
|
||||
===========================
|
||||
Installing on Digital Ocean
|
||||
===========================
|
||||
|
||||
Goal
|
||||
====
|
||||
|
||||
By the end of this tutorial, you should have a JupyterHub with some admin
|
||||
users and a user environment with packages you want installed running on
|
||||
`DigitalOcean <https://digitalocean.com>`_.
|
||||
|
||||
Pre-requisites
|
||||
==============
|
||||
|
||||
#. A DigitalOcean account with a payment method attached.
|
||||
|
||||
Step 1: Installing The Littlest JupyterHub
|
||||
==========================================
|
||||
|
||||
Let's create the server on which we can run JupyterHub.
|
||||
|
||||
#. Log in to `DigitalOcean <https://digitalocean.com>`_. You might need to
|
||||
attach a credit card or other payment method to your account before you
|
||||
can proceed with the tutorial.
|
||||
|
||||
#. Click the **Create** button on the top right, and select **Droplets** from
|
||||
the dropdown menu. DigitalOcean calls servers **droplets**.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/create-menu.png
|
||||
:alt: Dropdown menu on clicking 'create' in top right corner
|
||||
|
||||
This takes you to a page titled **Create Droplets** that lets you configure
|
||||
your server.
|
||||
|
||||
#. Under **Choose an image**, select **18.04 x64** under **Ubuntu**.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/select-image.png
|
||||
:alt: Select 18.04 x64 image under Ubuntu
|
||||
|
||||
#. Under **Choose a size**, select the size of the server you want. The default
|
||||
(4GB RAM, 2CPUs, 20 USD / month) is not a bad start. You can resize your server
|
||||
later if you need.
|
||||
|
||||
Check out our guide on How To :ref:`howto/resource-estimation` to help pick
|
||||
how much Memory, CPU & disk space your server needs.
|
||||
|
||||
#. Scroll down to **Select additional options**, and select **User data**.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/additional-options.png
|
||||
:alt: Turn on User Data in additional options
|
||||
|
||||
This opens up a textbox where you can enter a script that will be run
|
||||
when the server is created. We will use this to set up The Littlest JupyterHub
|
||||
on this server.
|
||||
|
||||
#. Copy the text below, and paste it into the user data text box. Replace
|
||||
``<admin-user-name>`` with the name of the first **admin user** for this
|
||||
JupyterHub. This admin user can log in after the JupyterHub is set up, and
|
||||
can configure it to their needs. Remember the username!
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
#!/bin/bash
|
||||
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py \
|
||||
| sudo python3 - \
|
||||
--admin <admin-user-name>
|
||||
|
||||
.. note::
|
||||
|
||||
See :ref:`topic/installer-actions` if you want to understand exactly what the installer is doing.
|
||||
:ref:`topic/customizing-installer` documents other options that can be passed to the installer.
|
||||
|
||||
#. Under the **Finalize and create** section, enter a ``hostname`` that descriptively
|
||||
identifies this server for you.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/hostname.png
|
||||
:alt: Select suitable hostname for your server
|
||||
|
||||
#. Click the **Create** button! You will be taken to a different screen,
|
||||
where you can see progress of your server being created.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/server-create-wait.png
|
||||
:alt: Server being created
|
||||
|
||||
#. In a few seconds your server will be created, and you can see the **public IP**
|
||||
used to access it.
|
||||
|
||||
.. image:: ../images/providers/digitalocean/server-create-done.png
|
||||
:alt: Server finished creating, public IP available
|
||||
|
||||
#. The Littlest JupyterHub is now installing in the background on your new server.
|
||||
It takes around 5-10 minutes for this installation to complete.
|
||||
|
||||
#. Check if the installation is complete by copying the **public ip**
|
||||
of your server, and trying to access it with a browser. This will fail until
|
||||
the installation is complete, so be patient.
|
||||
|
||||
#. When the installation is complete, it should give you a JupyterHub login page.
|
||||
|
||||
.. image:: ../images/first-login.png
|
||||
:alt: JupyterHub log-in page
|
||||
|
||||
#. Login using the **admin user name** you used in step 6, and a password. Use a
|
||||
strong password & note it down somewhere, since this will be the password for
|
||||
the admin user account from now on.
|
||||
|
||||
#. Congratulations, you have a running working JupyterHub!
|
||||
|
||||
Step 2: Adding more users
|
||||
==========================
|
||||
|
||||
.. include:: add_users.txt
|
||||
|
||||
Step 3: Install conda / pip packages for all users
|
||||
==================================================
|
||||
|
||||
.. include:: add_packages.txt
|
||||
@@ -1,205 +0,0 @@
|
||||
.. _tutorial_quickstart_google:
|
||||
|
||||
==========================
|
||||
Installing on Google Cloud
|
||||
==========================
|
||||
|
||||
Goal
|
||||
====
|
||||
|
||||
By the end of this tutorial, you should have a JupyterHub with some admin
|
||||
users and a user environment with packages you want installed running on
|
||||
`Google Cloud <https://cloud.google.com/>`_.
|
||||
|
||||
Prerequisites
|
||||
=============
|
||||
|
||||
#. A Google Cloud account. You might use the free credits for trying it out!
|
||||
|
||||
Step 1: Installing The Littlest JupyterHub
|
||||
==========================================
|
||||
|
||||
Let's create the server on which we can run JupyterHub.
|
||||
|
||||
#. Log in to `Google Cloud Console <https://console.cloud.google.com>`_ with
|
||||
your Google Account.
|
||||
|
||||
#. Open the navigation menu by clicking the button with three lines on the top
|
||||
left corner of the page.
|
||||
|
||||
.. image:: ../images/providers/google/left-menu-button.png
|
||||
:alt: Button to open the menu
|
||||
|
||||
This opens a menu with all the cloud products Google Cloud offers.
|
||||
|
||||
#. Under **Compute Engine**, select **VM Instances**.
|
||||
|
||||
.. image:: ../images/providers/google/vm-instances-menu.png
|
||||
:alt: Navigation Menu -> Compute Engine -> VM Instances
|
||||
|
||||
#. If you are using Google Cloud for the first time, you might have to
|
||||
enable billing. Google will present a screen asking you to enable billing
|
||||
to proceed. Click the **Enable Billing** button and follow any prompts
|
||||
that appear.
|
||||
|
||||
.. image:: ../images/providers/google/enable-billing.png
|
||||
:alt: Enable billing if needed.
|
||||
|
||||
It might take a few minutes for your account to be set up.
|
||||
|
||||
#. Once Compute Engine is ready, click the **Create** button to start
|
||||
creating the server that'll run TLJH.
|
||||
|
||||
.. image:: ../images/providers/google/create-vm-first.png
|
||||
:alt: Create VM page when using it for the first time.
|
||||
|
||||
If you already have VMs running in your project, the screen will look
|
||||
different. But you can find the **Create** button still!
|
||||
|
||||
#. This shows you a page titled **Create an instance**. This lets you customize
|
||||
the kind of server you want, the resources it will have & what it'll be called.
|
||||
|
||||
#. Under **Name**, give it a memorable name that identifies what purpose this
|
||||
JupyterHub will be used for.
|
||||
|
||||
#. **Region** specifies the physical location where this server will be hosted.
|
||||
Generally, pick something close to where most of your users are. Note that
|
||||
it might increase the cost of your server in some cases!
|
||||
|
||||
#. For **Zone**, pick any of the options. Leaving the default as is is fine.
|
||||
|
||||
#. Under **Machine** type, select the amount of CPU / RAM / GPU you want for your
|
||||
server.
|
||||
|
||||
You can select a preset combination in the default **basic view**.
|
||||
|
||||
.. image:: ../images/providers/google/machine-type-basic.png
|
||||
:alt: Select a preset VM type
|
||||
|
||||
If you want to add **GPUs**, you should click the **Customize** button &
|
||||
use the **Advanced View**. You need to request `a quota increase <https://cloud.google.com/compute/quotas#gpus>`_
|
||||
before you can use GPUs.
|
||||
|
||||
.. image:: ../images/providers/google/machine-type-advanced.png
|
||||
:alt: Select a customized VM size
|
||||
|
||||
Check out our guide on How To :ref:`howto/resource-estimation` to help pick
|
||||
how much Memory / CPU your server needs.
|
||||
|
||||
#. Under **Boot Disk**, click the **Change** button. This lets us change the
|
||||
operating system and the size of your disk.
|
||||
|
||||
.. image:: ../images/providers/google/boot-disk-button.png
|
||||
:alt: Changing Boot Disk & disk size
|
||||
|
||||
This should open a **Boot disk** popup.
|
||||
|
||||
#. Select **Ubuntu 18.04 LTS** from the list of operating system images.
|
||||
|
||||
.. image:: ../images/providers/google/boot-disk-ubuntu.png
|
||||
:alt: Selecting Ubuntu 18.04 for OS
|
||||
|
||||
#. You can also change the **type** and **size** of your disk at the bottom
|
||||
of this popup.
|
||||
|
||||
.. image:: ../images/providers/google/boot-disk-size.png
|
||||
:alt: Selecting Boot disk type & size
|
||||
|
||||
**Standard persistent disk** type gives you a slower but cheaper disk, similar
|
||||
to a hard drive. **SSD persistent disk** gives you a faster but more expensive
|
||||
disk, similar to an SSD.
|
||||
|
||||
Check out our guide on How To :ref:`howto/resource-estimation` to help pick
|
||||
how much Disk space your server needs.
|
||||
|
||||
#. Click the **Select** button to dismiss the Boot disk popup and go back to the
|
||||
Create an instance screen.
|
||||
|
||||
#. Under **Identity and API access**, select **No service account** for the
|
||||
**Service account** field. This prevents your JupyterHub users from automatically
|
||||
accessing other cloud services, increasing security.
|
||||
|
||||
.. image:: ../images/providers/google/no-service-account.png
|
||||
:alt: Disable service accounts for the server
|
||||
|
||||
#. Under **Firewall**, check both **Allow HTTP Traffic** and **Allow HTTPS Traffic**
|
||||
checkboxes.
|
||||
|
||||
.. image:: ../images/providers/google/firewall.png
|
||||
:alt: Allow HTTP & HTTPS traffic to your server
|
||||
|
||||
#. Click the **Management, disks, networking, SSH keys** link to expand more
|
||||
options.
|
||||
|
||||
.. image:: ../images/providers/google/management-button.png
|
||||
:alt: Expand management options by clicking link.
|
||||
|
||||
This displays a lot of advanced options, but we'll be only using one of them.
|
||||
|
||||
#. Copy the text below, and paste it into the **Starup script** text box. Replace
|
||||
``<admin-user-name>`` with the name of the first **admin user** for this
|
||||
JupyterHub. This admin user can log in after the JupyterHub is set up, and
|
||||
can configure it to their needs. Remember the username!
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
#!/bin/bash
|
||||
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py \
|
||||
| sudo python3 - \
|
||||
--admin <admin-user-name>
|
||||
|
||||
.. image:: ../images/providers/google/startup-script.png
|
||||
:alt: Install JupyterHub with the Startup script textbox
|
||||
|
||||
.. note::
|
||||
|
||||
See :ref:`topic/installer-actions` if you want to understand exactly what the installer is doing.
|
||||
:ref:`topic/customizing-installer` documents other options that can be passed to the installer.
|
||||
|
||||
#. Click the **Create** button at the bottom to start your server!
|
||||
|
||||
.. image:: ../images/providers/google/create-vm-button.png
|
||||
:alt: Launch an Instance / Advanced Options dialog box
|
||||
|
||||
#. We'll be sent to the **VM instances** page, where we can see that our server
|
||||
is being created.
|
||||
|
||||
.. image:: ../images/providers/google/vm-creating.png
|
||||
:alt: Spinner with vm creating
|
||||
|
||||
#. In a few seconds your server will be created, and you can see the **External IP**
|
||||
used to access it.
|
||||
|
||||
.. image:: ../images/providers/google/vm-created.png
|
||||
:alt: VM created, external IP available
|
||||
|
||||
#. The Littlest JupyterHub is now installing in the background on your new server.
|
||||
It takes around 5-10 minutes for this installation to complete.
|
||||
|
||||
#. Check if the installation is complete by **copying** the **External IP**
|
||||
of your server, and trying to access it with a browser. Do **not click** on the
|
||||
IP - this will open the link with HTTPS, and will not work.
|
||||
|
||||
Accessing the JupyterHub will also fail until the installation is complete,
|
||||
so be patient.
|
||||
|
||||
#. When the installation is complete, it should give you a JupyterHub login page.
|
||||
|
||||
.. image:: ../images/first-login.png
|
||||
:alt: JupyterHub log-in page
|
||||
|
||||
#. Login using the **admin user name** you used in step 6, and a password. Use a
|
||||
strong password & note it down somewhere, since this will be the password for
|
||||
the admin user account from now on.
|
||||
|
||||
#. Congratulations, you have a running working JupyterHub!
|
||||
|
||||
Step 2: Adding more users
|
||||
==========================
|
||||
|
||||
.. include:: add_users.txt
|
||||
|
||||
Step 3: Install conda / pip packages for all users
|
||||
==================================================
|
||||
|
||||
.. include:: add_packages.txt
|
||||
@@ -1,144 +0,0 @@
|
||||
.. _tutorial_quickstart_jetstream:
|
||||
|
||||
=======================
|
||||
Installing on Jetstream
|
||||
=======================
|
||||
|
||||
Goal
|
||||
====
|
||||
|
||||
By the end of this tutorial, you should have a JupyterHub with some admin
|
||||
users and a user environment with packages you want installed running on
|
||||
`Jetstream <https://jetstream-cloud.org/>`_.
|
||||
|
||||
Prerequisites
|
||||
=============
|
||||
|
||||
#. A Jetstream account with an XSEDE allocation; for more information,
|
||||
see the `Jetstream Allocations help page <http://wiki.jetstream-cloud.org/Jetstream+Allocations>`_.
|
||||
|
||||
Step 1: Installing The Littlest JupyterHub
|
||||
==========================================
|
||||
|
||||
Let's create the server on which we can run JupyterHub.
|
||||
|
||||
#. Log in to `the Jetstream portal <https://use.jetstream-cloud.org/>`_. You need an allocation
|
||||
to launch instances.
|
||||
|
||||
#. Select the **Launch New Instance** option to get going.
|
||||
|
||||
.. image:: ../images/providers/jetstream/launch-instance-first-button.png
|
||||
:alt: Launch new instance button with description.
|
||||
|
||||
This takes you to a page with a list of base images you can choose for your
|
||||
server.
|
||||
|
||||
#. Under **Image Search**, search for **Ubuntu 18.04**, and select the
|
||||
**Ubuntu 18.04 Devel and Docker** image.
|
||||
|
||||
.. image:: ../images/providers/jetstream/select-image.png
|
||||
:alt: Select Ubuntu 18.04 x64 image from image list
|
||||
|
||||
#. Once selected, you will see more information about this image. Click the
|
||||
**Launch** button on the top right.
|
||||
|
||||
.. image:: ../images/providers/jetstream/launch-instance-second-button.png
|
||||
:alt: Launch selected image with Launch button on top right
|
||||
|
||||
#. A dialog titled **Launch an Instance / Basic Options** pops up, with various
|
||||
options for configuring your instance.
|
||||
|
||||
.. image:: ../images/providers/jetstream/launch-instance-dialog.png
|
||||
:alt: Launch an Instance / Basic Options dialog box
|
||||
|
||||
#. Give your server a descriptive **Instance Name**.
|
||||
#. Select an appropriate **Instance Size**. We suggest m1.medium or larger.
|
||||
|
||||
Check out our guide on How To :ref:`howto/resource-estimation` to help pick
|
||||
how much Memory, CPU & disk space your server needs.
|
||||
|
||||
#. If you have multiple allocations, make sure you are 'charging' this server
|
||||
to the correct allocation.
|
||||
|
||||
#. Click the **Advanced Options** link in the bottom left of the popup. This
|
||||
lets us configure what the server should do when it starts up. We will use
|
||||
this to install The Littlest JupyterHub.
|
||||
|
||||
A dialog titled **Launch an Instance / Advanced Options** should pop up.
|
||||
|
||||
.. image:: ../images/providers/jetstream/add-deployment-script-dialog.png
|
||||
:alt: Dialog box allowing you to add a new script.
|
||||
|
||||
#. Click the **Create New Script** button. This will open up another dialog
|
||||
box!
|
||||
|
||||
.. image:: ../images/providers/jetstream/create-script-dialog.png
|
||||
:alt: Launch an Instance / Advanced Options dialog box
|
||||
|
||||
#. Under **Input Type**, select **Raw Text**. This should make a text box titled
|
||||
**Raw Text** visible on the right side of the dialog box.
|
||||
Copy the text below, and paste it into the **Raw Text** text box. Replace
|
||||
``<admin-user-name>`` with the name of the first **admin user** for this
|
||||
JupyterHub. This admin user can log in after the JupyterHub is set up, and
|
||||
can configure it to their needs. Remember the username!
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
#!/bin/bash
|
||||
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py \
|
||||
| sudo python3 - \
|
||||
--admin <admin-user-name>
|
||||
|
||||
.. note::
|
||||
|
||||
See :ref:`topic/installer-actions` if you want to understand exactly what the installer is doing.
|
||||
:ref:`topic/customizing-installer` documents other options that can be passed to the installer.
|
||||
|
||||
#. Under **Execution Strategy Type**, select **Run script on first boot**.
|
||||
|
||||
#. Under **Deployment Type**, select **Wait for script to complete**.
|
||||
|
||||
#. Click the **Save and Add Script** button on the bottom right. This should hide
|
||||
the dialog box.
|
||||
|
||||
#. Click the **Continue to Launch** button on the bottom right. This should put you
|
||||
back in the **Launch an Instance / Basic Options** dialog box again.
|
||||
|
||||
#. Click the **Launch Instance** button on the bottom right. This should turn it
|
||||
into a spinner, and your server is getting created!
|
||||
|
||||
.. image:: ../images/providers/jetstream/launching-spinner.png
|
||||
:alt: Launch button turns into a spinner
|
||||
|
||||
#. You'll now be shown a dashboard with all your servers and their states. The
|
||||
server you just launched will progress through various stages of set up,
|
||||
and you can see the progress here.
|
||||
|
||||
.. image:: ../images/providers/jetstream/deployment-in-progress.png
|
||||
:alt: Instances dashboard showing deployment in progress.
|
||||
|
||||
#. It will take about ten minutes for your server to come up. The status will
|
||||
say **Active** and the progress bar will be a solid green. At this point,
|
||||
your JupyterHub is ready for use!
|
||||
|
||||
#. Copy the **IP Address** of your server, and try accessing it from a web
|
||||
browser. It should give you a JupyterHub login page.
|
||||
|
||||
.. image:: ../images/first-login.png
|
||||
:alt: JupyterHub log-in page
|
||||
|
||||
#. Login using the **admin user name** you used in step 8, and a password. Use a
|
||||
strong password & note it down somewhere, since this will be the password for
|
||||
the admin user account from now on.
|
||||
|
||||
#. Congratulations, you have a running working JupyterHub!
|
||||
|
||||
Step 2: Adding more users
|
||||
==========================
|
||||
|
||||
.. include:: add_users.txt
|
||||
|
||||
Step 3: Install conda / pip packages for all users
|
||||
==================================================
|
||||
|
||||
.. include:: add_packages.txt
|
||||
Reference in New Issue
Block a user