GeoTUI - GeoServer Manager
Manage your GeoServer instances from the terminal
What is GeoTUI?
GeoTUI is a terminal application for managing GeoServer instances. It provides a dual-pane interface inspired by Midnight Commander — browse your local geospatial files on the left, manage GeoServer workspaces and layers on the right.
Who is it for? GIS administrators, data engineers, and anyone who publishes geospatial data to GeoServer and prefers working from the command line.
Why use it? Publishing data to GeoServer normally requires navigating the web admin, uploading files, configuring stores, and creating layers — all through a browser. GeoTUI lets you do all of this in a single keystroke: select your files, press F5, done. It also generates PDF reports of every publish operation.
When would you use it? Whenever you need to publish Shapefiles, GeoPackages, or GeoTIFFs to a GeoServer instance — whether it's a local development server or a production deployment on GeoSpatialHosting.
Key Features
- Dual-pane interface — local files on the left, GeoServer tree on the right
- One-click publishing — select files, press F5, layers are created automatically
- Multiple connections — manage several GeoServer instances simultaneously
- PDF reports — every publish operation generates a detailed report
- Encrypted credentials — master password vault with AES encryption (PBKDF2, 600k iterations)
- Cross-platform — standalone binaries for Windows, Linux, and macOS
- Multilingual — English, Portuguese, and Spanish
Quick Start
1. Install
Download from the latest release, or:
pip install geotui
2. Launch
geotui
3. Connect
Press F9 to open Settings, click Add, enter your GeoServer URL and credentials.
4. Publish
Navigate to your data in the left pane, select a workspace in the right pane, press F5.
For a detailed walkthrough with screenshots, see the Getting Started guide.
Keyboard Shortcuts
| Key | Action |
|---|---|
| Tab | Switch between panes |
| F2 | GeoServer Actions (create workspace, etc.) |
| F5 | Publish selected files to GeoServer |
| F7 | Create directory |
| F8 | Delete |
| F9 | Settings / Connection manager |
| F10 / q | Quit |
| Ctrl+L | Cycle language (EN / PT / ES) |
Start Here
New to GeoTUI? Follow these guides in order:
| Step | Guide | What you'll learn |
|---|---|---|
| 1 | Getting Started | Install, set up your master password, add a GeoServer connection |
| 2 | Navigation | Dual-pane layout, keyboard shortcuts, switching panes |
| 3 | Configuration | Credential vault, language switching, colour palette |
| 4 | Connecting to GSH | Set up a hosted GeoServer on GeoSpatialHosting |
All Documentation
- Getting Started — install, connect, and publish your first data
- Navigation — keyboard shortcuts and publishing workflow
- Connecting to GSH — hosted GeoServer on GeoSpatialHosting
- Configuration — vault, language, and colour settings
- Installation — all platforms and package formats
- Security — encryption, threat model, vulnerability reporting
- Architecture — module structure and design decisions
- API Reference — full Python API documentation
- Contributing — development setup and how to help
- Security & Supply Chain — SBOM, CVE scanning, auditing
Sustainable Funding
GeoTUI is free and open source. If you find it useful, please consider supporting its development through GitHub Sponsors.
by