mirror of
https://github.com/jupyterhub/the-littlest-jupyterhub.git
synced 2025-12-18 21:54:05 +08:00
fix absolute refs
myst seems to create different refs than sphinx
This commit is contained in:
@@ -27,4 +27,4 @@ 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:`howto/env/user_environment` for more information.
|
||||
See :ref:`howto-env-user-environment` for more information.
|
||||
|
||||
@@ -72,7 +72,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
offers. Select the one you want and then select the button
|
||||
`Next: Configure Instance Details` in the lower right corner.
|
||||
|
||||
Check out our guide on How To {ref}`howto/admin/resource-estimation` to help pick
|
||||
Check out our guide on How To [](/howto/admin/resource-estimation) to help pick
|
||||
how much Memory / CPU your server needs.
|
||||
We recommend you use a server with at least 2GB of RAM, such as a **t3.small**.
|
||||
However, if you need to minimise costs you can use a server with **1GB** RAM such as a **t2.micro**, but performance will be limited.
|
||||
@@ -101,8 +101,8 @@ Let's create the server on which we can run JupyterHub.
|
||||
```
|
||||
|
||||
:::{note}
|
||||
See {ref}`topic/installer-actions` for a detailed description and
|
||||
{ref}`topic/customizing-installer` for other options that can be used.
|
||||
See [](/topic/installer-actions) for a detailed description and
|
||||
[](/topic/customizing-installer) for other options that can be used.
|
||||
:::
|
||||
|
||||
8. Under **Step 4: Add Storage**, you can change the **size** and **type of your
|
||||
@@ -112,7 +112,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
:alt: Selecting disk size and type
|
||||
```
|
||||
|
||||
Check out {ref}`howto/admin/resource-estimation` to help pick
|
||||
Check out [](/howto/admin/resource-estimation) to help pick
|
||||
how much Disk space your server needs.
|
||||
|
||||
Hover over the encircled `i` next to **Volume Type** for an explanation of
|
||||
|
||||
@@ -161,8 +161,8 @@ A new screen with all the options for Virtual Machines in Azure will displayed.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
8. Check the summary and confirm the creation of your Virtual Machine.
|
||||
|
||||
@@ -14,7 +14,7 @@ on your personal computer.
|
||||
:::{note}
|
||||
Running TLJH _inside_ a docker container is not supported, since we depend
|
||||
on systemd. If you want to run TLJH locally for development, see
|
||||
{ref}`contributing/dev-setup`.
|
||||
[](/contributing/dev-setup).
|
||||
:::
|
||||
|
||||
## Goal
|
||||
@@ -31,7 +31,7 @@ a server you have access to.
|
||||
4. Ability to `ssh` into the server & run commands from the prompt.
|
||||
5. An **IP address** where the server can be reached from the browsers of your target audience.
|
||||
|
||||
If you run into issues, look at the specific {ref}`troubleshooting guide <troubleshooting/providers/custom>`
|
||||
If you run into issues, look at the specific [troubleshooting guide](/troubleshooting/providers/custom)
|
||||
for custom server installations.
|
||||
|
||||
## Step 1: Installing The Littlest JupyterHub
|
||||
@@ -56,8 +56,8 @@ for custom server installations.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
4. Press `Enter` to start the installation process. This will take 5-10 minutes,
|
||||
@@ -92,4 +92,4 @@ for custom server installations.
|
||||
## Step 4: Setup HTTPS
|
||||
|
||||
Once you are ready to run your server for real, and have a domain, it's a good
|
||||
idea to proceed directly to {ref}`howto/admin/https`.
|
||||
idea to proceed directly to [](/howto/admin/https).
|
||||
|
||||
@@ -40,7 +40,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
(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/admin/resource-estimation` to help pick
|
||||
Check out our guide on How To [](/howto/admin/resource-estimation) to help pick
|
||||
how much Memory, CPU & disk space your server needs.
|
||||
|
||||
5. Scroll down to **Select additional options**, and select **User data**.
|
||||
@@ -66,8 +66,8 @@ Let's create the server on which we can run JupyterHub.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
7. Under the **Finalize and create** section, enter a `hostname` that descriptively
|
||||
|
||||
@@ -84,7 +84,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
:alt: Select a customized VM size
|
||||
```
|
||||
|
||||
Check out our guide on How To {ref}`howto/admin/resource-estimation` to help pick
|
||||
Check out our guide on How To [](/howto/admin/resource-estimation) to help pick
|
||||
how much Memory / CPU your server needs.
|
||||
|
||||
11. Under **Boot Disk**, click the **Change** button. This lets us change the
|
||||
@@ -113,7 +113,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
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/admin/resource-estimation` to help pick
|
||||
Check out our guide on How To [](/howto/admin/resource-estimation) to help pick
|
||||
how much Disk space your server needs.
|
||||
|
||||
14. Click the **Select** button to dismiss the Boot disk popup and go back to the
|
||||
@@ -160,8 +160,8 @@ Let's create the server on which we can run JupyterHub.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
19. Click the **Create** button at the bottom to start your server!
|
||||
|
||||
@@ -55,7 +55,7 @@ Let's create the server on which we can run JupyterHub.
|
||||
2. Select an appropriate **Instance Size**. We suggest m1.medium or larger.
|
||||
Make sure your instance has at least **1GB** of RAM.
|
||||
|
||||
Check out our guide on How To {ref}`howto/admin/resource-estimation` to help pick
|
||||
Check out our guide on How To [](/howto/admin/resource-estimation) to help pick
|
||||
how much Memory, CPU & disk space your server needs.
|
||||
|
||||
3. If you have multiple allocations, make sure you are 'charging' this server
|
||||
@@ -93,8 +93,8 @@ Let's create the server on which we can run JupyterHub.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
9. Under **Execution Strategy Type**, select **Run script on first boot**.
|
||||
|
||||
@@ -77,8 +77,8 @@ Let's create the server on which we can run JupyterHub.
|
||||
```
|
||||
|
||||
:::{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.
|
||||
See [](/topic/installer-actions) if you want to understand exactly what the installer is doing.
|
||||
[](/topic/customizing-installer) documents other options that can be passed to the installer.
|
||||
:::
|
||||
|
||||
```{image} ../images/providers/ovh/configuration.png
|
||||
|
||||
Reference in New Issue
Block a user