Skip to main content

Connecting

Before you can run GRASS modules or add layers you need to point the GRASS Runner at a running FastGIS server and supply an API token.

Connection panel

Open the Connection section in the left panel. You will find two fields:

FieldDescription
Base URLThe root URL of the FastGIS server, e.g. https://fastgis.example.com
X-API-KeyYour personal API token (generated in Settings → Profile)

Click Connect & load environments to validate the connection and populate the Environment dropdowns.

Generating an API token

  1. Log in and navigate to Profile (top-right menu)
  2. Click Generate token
  3. Copy the token — it is only shown once
caution

Store your token securely. Anyone with the token can run GRASS modules on your behalf.

Selecting an environment

After connecting, choose a Location and Mapset from the dropdowns. The environment id shown below the selects (location/mapset) is used in all subsequent API calls.

Persisted credentials

The base URL is saved to localStorage automatically. The API key is never stored in localStorage — you need to re-enter it after a page refresh, or use the Workspace autosave feature which stores connection details in the session state.