Tethys Platform 4.3

Last Updated: April 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.3 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:

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 will automatically open to http://127.0.0.1:8000/.

Username: admin

Password: pass

Voilá! Your very own Hello World application!

Time to develop! The code behind your Hello World app can be found in your current working directory in the newly-created tethysapp-hello_world folder.

Next Steps

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

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