Web UI
InSARHub includes a built-in web interface that lets you run the full InSAR workflow from a browser — no Python scripting required.
Launch
After installing InSARHub, start the web server with:
Then open http://127.0.0.1:8000 in your browser.
Options:
insarhub-app -w /data/bryce # set working directory
insarhub-app --host 0.0.0.0 # expose to your local network
insarhub-app --port 8080 # change port
insarhub-app --version # print version and exit
The -w / --workdir flag pre-sets the working directory so you do not need to configure it in the Settings panel after launch. If omitted, the directory where you run insarhub-app is used.
Interface Overview
InSARHub Web UI — map, toolbar, and job panel.
Top Bar
The top bar contains the main search controls:
| Control | Description |
|---|---|
| Start / End date | Date range for SAR scene search |
| Search | Run an ASF scene search for the current AOI |
| Settings | Open the global settings panel |
| Jobs | Open the Job Folders drawer |
| Theme | Toggle dark / light mode |
Drawing an AOI
Click one of the draw tools on the left side of the map:
| Tool | Behavior |
|---|---|
| ⬜ Box | Click once to set the first corner, move mouse to preview, click again to finish |
| ⬡ Polygon | Click to add vertices, double-click to close |
| 📍 Pin | Click to place a point |
| 📂 Shapefile | Upload a .zip shapefile |
Click the active tool again to cancel drawing.
Map Navigation
| Action | How |
|---|---|
| Pan | Right-click and drag |
| Zoom | Scroll wheel or use the +/− buttons |
| Click footprint | Left-click to select and view scene details |
Search & Results
- Draw an AOI on the map
- Set a date range in the top bar
- Click Search — scene footprints appear on the map as colored outlines
- Click any footprint to view scene details (path, frame, date, polarization)
Settings
Click the ⚙ Settings button to configure:
- General — working directory, download workers
- Auth — Earthdata and CDSE credentials
- Downloader — downloader type and parameters
- Processor — processor type and parameters
- Analyzer — per-analyzer config (each analyzer type stores its own settings independently)
Job Folders
Click Jobs to open the Job Folders drawer. InSARHub scans your working directory and lists all subfolders that contain recognized workflow files.
Each folder shows clickable role tags:
| Tag | What it means |
|---|---|
| Downloader | Folder has a downloader_config.json |
| Processor | Folder has a hyp3_jobs.json |
| Analyzer | Folder has a mintpy.cfg |
Click a tag to open that role's panel. Click 🗑 to delete the entire job folder.
Next Steps
For detailed usage of each panel, see: