Tethys Platform 4.5

Last Updated: August 2025

Tethys is a platform that can be used to develop and host geoscientific web apps. It includes a suite of free and open source software (FOSS) that has been carefully selected to address the unique development needs of geoscientific web apps. Tethys web apps are developed using a Python software development kit (SDK) which includes programmatic links to each software component. Tethys Platform is powered by the Django Python web framework giving it a solid web foundation with excellent security and performance. Refer to the Features article for an overview of the features of Tethys Platform.

Important

Tethys Platform 4.5 has arrived! Check out the What's New article for a description of the new features and changes.

Quick Start

First create a Virtual Environment with the tool of your choice and then run the following commands to download and install the Tethys Platform package:

conda install -c conda-forge tethys-platform
tethys quickstart

pip install tethys-platform
tethys quickstart

Tip

To learn what goes on behind the scenes during tethys quickstart see Detailed Installation.

Your browser should automatically open to http://127.0.0.1:8000/. If not, we apologize! Please open it up yourself.

Voilá! Your very own Tethys Portal!

Username: admin

Password: pass

Now to get some apps loaded...

Next Steps

There are several directions that you may want to go from here.

Learn how to Scaffold and Install an App via the Portal.
Learn how to Scaffold and Install an App via Command Line.
Install an app you have already developed using the Application Installation guide.
Complete one or more Tutorials to learn how to develop apps using Tethys Platform.
Install one or both of the Showcase Apps to see live demos and code examples of Gizmos and Layouts.
Checkout the Web Admin Setup docs to customize your Tethys Portal.
For help getting started with docker see Using Docker

Acknowledgements

This material is based upon work supported by the National Science Foundation under Grants 1135482 and 2303756.

Tutorials