Ecoscope Web: Register, Log In, and Add an EarthRanger Data Source
Purpose​
This guide walks you through the first setup steps for Ecoscope Web:
- Create an Ecoscope account (if you don't already have one).
- Log in to Ecoscope Web.
- Connect an EarthRanger site as a data source.
Before you start​
Ecoscope and EarthRanger are separate platforms with separate logins:
- Your Ecoscope email and password log you in to Ecoscope Web.
- Your EarthRanger username and password are used only when you connect an EarthRanger site as a data source, and may differ from your Ecoscope credentials.
Read more about Ecoscope here: Introduction to Ecoscope
Make sure you have:
| Requirement | Why you need it |
|---|---|
| An Ecoscope account | Required to log in to Ecoscope Web. |
| Your EarthRanger site URL or domain | Used when creating the data source connection. |
| Your EarthRanger username and password | Required to authenticate the data source. |
| Access to the EarthRanger site | The connection only works if you have valid access to that EarthRanger instance. |
Step 1: Create an Ecoscope account​
Skip this step if you already have an Ecoscope account.
- Go to app.ecoscope.io.
- Select Sign up.
- Complete the form with the email address you want to use for Ecoscope.
- Submit the form.
- Check your email for a confirmation message from Ecoscope, and follow the link to set your password.
Step 2: Log in to Ecoscope Web​
- Go to app.ecoscope.io.
- Select Log in.
- Enter your registered Ecoscope email and password.
- Select Log In.
If you can't log in​
| Issue | What to do |
|---|---|
| Wrong email address | Confirm the email you used to register with Ecoscope. |
| Forgotten password | Use the password reset option on the login page. |
| No account yet | Go back to Step 1 and sign up. |
| Using EarthRanger credentials | Log in with your Ecoscope email and password. EarthRanger credentials are only used later, when adding a data source. |
Step 3: Connect an EarthRanger data source​
- Select Data Sources in the top navigation bar.
- Check whether the EarthRanger site you want to analyze is already listed. If it is, skip to Step 5.
- Select Connect Data Source.
- Complete the required fields (see below).
- Select Save or Connect, depending on the button shown.
- Wait for Ecoscope to validate and store the connection.
Step 4: Required fields​
| Field | What to enter | Guidance |
|---|---|---|
| Data Source Name | A clear, descriptive name for the connection. | Identify the EarthRanger site, e.g. Khao Sok EarthRanger. Avoid vague names like Test or Main. |
| EarthRanger URL | The EarthRanger site's domain. | Enter only the domain, without https:// or .pamdas.com. For the site https://er-asia.pamdas.com, enter er-asia. |
| Username | Your EarthRanger username. | Not your Ecoscope username, unless your organization has deliberately set them to match. |
| Password | Your EarthRanger password. | Not your Ecoscope password, unless your organization has deliberately set them to match. |
Step 5: Confirm the data source was added​
Once the connection is saved, it should appear in the Data Sources list with:
- The data source name
- The EarthRanger domain
- The connection type
- A created or updated timestamp
Your Ecoscope Web account is now set up, with at least one EarthRanger data source ready for analysis. Continue with Ecoscope Workflows and Data Analysis.
Common setup problems​
| Problem | Likely cause | What to check |
|---|---|---|
| Login fails | Wrong Ecoscope email or password. | Confirm your registered Ecoscope email, or use password reset. |
| Can't find the Data Sources section | Not logged in, or on the wrong page. | Confirm you're in Ecoscope Web and can see the top navigation bar. |
| Data source connection fails | Wrong credentials. | Confirm you entered EarthRanger credentials, not Ecoscope credentials. |
| EarthRanger URL is rejected | URL format doesn't match the field's requirement. | Try the full domain if the form accepts one; otherwise enter only the site name or domain prefix. |
| A previously connected data source stops loading | The connection may have expired. | Reconnect the data source from the Data Sources page if prompted. |
For additional help, visit the EarthRanger Help Center or contact your site administrator.