SEPAL applications#

Access complex workflows without the need of digital programming skills with SEPAL applications#


SEPAL applications are tools provided by the SEPAL team from the Food and Agriculture Organization of the United Nations (FAO) or other developers. These tools are based on advanced geographic information system (GIS) libraries and complement the functionalities of SEPAL recipes, providing the end user with access to complex workflows without requiring knowledge of digital programming. These applications are served in SEPAL with attractive user interfaces to ensure the best possible user experience.

They run on various shells – from pure HTML and Shiny-based R apps to Jupyter-powered Python kernels. This flexibility and variety of tools allows developers to integrate workflows and make them available for SEPAL users. Review the module documentation below to learn more about its usage.

Start applications#

To start a SEPAL application, go to the dashboard of the application by selecting the wrench icon on the left side of the window [(1) on the following image], which will bring up a list of apps you can run in SEPAL. More information about each app is found by selecting the i on the right side.

Note: The top three apps (2) are code editors, not apps:

  • R Studio: Provides access to the R environment where you can run processing scripts and upload data to your SEPAL folder.

  • Jupyter Notebook: An open-source web application that allows you to create and share documents that contain live code, equations, visualizations and narrative text (supports Kernels in many different languages, including R, Python and NodesJS).

  • JupyterLab: A web-based interactive development environment for Jupyter notebooks, code and data.

To find the application you’re looking for, you can navigate through the different app pages (3), use tags (4), or utilize the search bar (5).

Once the desired application is found, select it to initiate the process. This will start the smallest instance to run the SEPAL sandbox (t1).

Refer to the next section to start a specific instance manually.


Applications that include a in their descriptor require a connection to Google Earth Engine (GEE) to run. For more information, see Use GEE with SEPAL.


An application relies on numerous tools and systems to run. Since it can take up to five minutes to start, stay patient and avoid rushing. If the application doesn’t start after five minutes, it could simply be an issue with the Amazon cloud connection; we recommend closing the tab and starting again. In the event of a major bug or crash, please report the issue in the specific app issue tracker or directly in SEPAL.


To avoid disturbances in the application workflow, avoid stopping instances manually and disconnecting from SEPAL. While completed work will be available in SEPAL folders, you will need to restart the process in order to finish.

Start instance manually#

Some applications require more powerful instances than the default t1. If the app documentation requires the user to start a specific instance type (e.g. a GPU machine g4 or g8), follow these steps prior to initiating the application:

  1. Go to the SEPAL terminal and wait for the instance selector to start.

  2. Type the instance name suggested in the documentation of your app and press Enter.

  3. Wait for the instance to finish loading.

  4. Go back to the dashboard of the application to launch your app. It will automatically be using the instance you opened and won’t restart a t1.