You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/install/jetstream.md
+39-36Lines changed: 39 additions & 36 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,15 +17,15 @@ users and a user environment with packages you want installed running on
17
17
18
18
We'll create a new Jetstream 2 virtual machine and have it automatically install The Littlest JupyterHub (TLJH) at first boot.
19
19
20
-
1. Log in to the [Jetstream 2 portal](https://use.jetstream-cloud.org/). You must have (and select) an allocation in order to launch instances. Click the allocation you want to charge.
21
-
2. Click **Create** ➜ **Instance**.
22
-
3. From the list of images, select **Ubuntu 24.04** (Jammy or newer is required for current TLJH releases).
23
-
4. In the **Create Instance** dialog:
20
+
1.Log in to the [Jetstream 2 portal](https://use.jetstream-cloud.org/). You must have (and select) an allocation in order to launch instances. Click the allocation you want to charge.
21
+
2.Click **Create** ➜ **Instance**.
22
+
3.From the list of images, select **Ubuntu 24.04** (Jammy or newer is required for current TLJH releases).
23
+
4.In the **Create Instance** dialog:
24
24
1. Set a descriptive **Instance Name** (this is used in the default hostname and helps users recognize it).
25
25
2. Choose an **Instance Size**. We suggest `m3.small` (2 vCPUs / 8 GiB RAM) or larger for more than a couple of users. The absolute minimum TLJH can start with is about **1 GiB** RAM, but you'll quickly run out with real workloads.
26
-
- See the resource estimation guide: [Choosing resources](/howto/admin/resource-estimation) for help picking CPU, RAM, and disk.
26
+
- See the resource estimation guide: [Choosing resources](/howto/admin/resource-estimation) for help picking CPU, RAM, and disk.
27
27
3. (Optional) Increase the **Volume Size** if you expect many users or large datasets. You can not easily shrink later.
28
-
5. Expand **Advanced Options**, then locate the **Boot Script** field. Replace any placeholder content with the following script (the whole content should just be this):
28
+
5.Expand **Advanced Options**, then locate the **Boot Script** field. Replace any placeholder content with the following script (the whole content should just be this):
29
29
30
30
```bash
31
31
#!/bin/bash
@@ -40,21 +40,23 @@ We'll create a new Jetstream 2 virtual machine and have it automatically install
40
40
Notes:
41
41
- The script runs only once, during the initial boot.
42
42
- Keep it minimal—adding extra commands often slows install or causes failures if something prompts for input.
43
-
6. Launch the instance (click **Create Instance** / **Launch**).
44
-
7. You'll return to the instances dashboard. Your new instance will transition through provisioning states. It generally takes about 5 minutes for the TLJH install to finish after the VM first reports as active.
45
-
8. Once the status shows **Ready** (or the VM indicates it is running), copy the displayed **Hostname**. It looks like:
43
+
44
+
6. Launch the instance (click **Create Instance** / **Launch**).
45
+
7. You'll return to the instances dashboard. Your new instance will transition through provisioning states. It generally takes about 5 minutes for the TLJH install to finish after the VM first reports as active.
46
+
8. Once the status shows **Ready** (or the VM indicates it is running), copy the displayed **Hostname**. It looks like:
9. Open that hostname in a web browser (http on port 80). You should see the JupyterHub login page. Your browser will warn about the site not being secure (no HTTPS)—we'll enable HTTPS in the next step.
51
+
52
+
9. Open that hostname in a web browser (http on port 80). You should see the JupyterHub login page. Your browser will warn about the site not being secure (no HTTPS)—we'll enable HTTPS in the next step.
51
53
10. Log in with the `<admin-user-name>` you used in the boot script. Since this is the first login, you'll be prompted to set a password. Choose a strong password and store it safely. This password is now the credential for that admin user.
52
54
11. (Optional) Verify the install by SSHing to the instance as `exouser` (Jetstream's default user):
* Make sure ports 80 and 443 are open in your Jetstream security group (they are open by default for new projects; adjust only if you customized network policies).
84
-
* If you later attach a custom domain, add it with another `add-item` command and reload the proxy again.
85
+
86
+
- Make sure ports 80 and 443 are open in your Jetstream security group (they are open by default for new projects; adjust only if you customized network policies).
87
+
- If you later attach a custom domain, add it with another `add-item` command and reload the proxy again.
85
88
86
89
## Step 3: Customize your JupyterHub deployment
87
90
88
91
Next common tasks:
89
92
90
-
* Add additional users or admins: [User management](/howto/admin/add-users)
91
-
* Install Python / conda packages for all users: [Customize user environment](/howto/user-env)
92
-
* Install optional system packages: `sudo apt install <package>` (restart user servers afterwards)
93
-
* Pre-install JupyterLab extensions: see [Enable extensions](/howto/admin/enable-extensions)
0 commit comments