Skip to content

add hub image instructions #52

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kyle-lesinger merged 1 commit into from
Jan 26, 2026
Merged

add hub image instructions #52

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions Jupyterhub/loading-disaster-hub-image.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: "Loading Disaster Hub Image"
---

## Overview

This guide walks you through loading a custom Docker image in the Disasters JupyterHub environment.

## Steps to Load Custom Image

### 1. Login to JupyterHub

Navigate to [https://hub.disasters.2i2c.cloud/](https://hub.disasters.2i2c.cloud/) and log in with your credentials.

### 2. Select My Server

After logging in, you'll see the server management screen. Click on "Start My Server" or manage your existing servers.

![JupyterHub Login Screen](images/login-screen-hub.png)

### 3. Choose Environment

In the Server Options page, locate the **Environment** dropdown and select **"Bring your own image"**.

![Select Environment](images/select-image-hub.png)

### 4. Enter Custom Image

In the **Custom image** field, enter the following Docker image:

```
klesinger/disasters-jupyterhub-docker-image
```

![Add Custom Image](images/add-image-hub.png)

### 5. Start Server

Click the **Start** button to launch your JupyterHub server with the custom Disasters image.

## Running Sentinel-2 Algorithms

Once your server is running, you can process Sentinel-2 data using the pre-configured workflows.

### Access the Sentinel-2 Workflow

1. Navigate to the **shared-readwrite** directory in your JupyterHub file browser
2. Open the **process_sentinel2** directory
3. Launch the **sentinel2_workflow.ipynb** notebook
4. Configure the notebook parameters as needed for your specific use case
5. Run the cells to process Sentinel-2 imagery

The workflow notebook contains pre-configured algorithms for common Sentinel-2 data processing tasks.
1 change: 1 addition & 0 deletions _quarto.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@ website:
text: JupyterHub
contents:
- Jupyterhub/jupyterhub-training-guide.qmd
- Jupyterhub/loading-disaster-hub-image.qmd
- Jupyterhub/clone_conversion_repo.ipynb
- section: workflow.qmd
text: Data Workflow Diagrams
Expand Down