Install Ecoscope Desktop

Ecoscope Desktop is installed locally on your computer and allows you to run Ecoscope workflows outside of the web browser. After installation, workflows can be executed directly from your machine using the same workflow templates used in Ecoscope Web.

Before You Begin

Before installing Ecoscope Desktop, ensure that:

  • You have permission to install applications on your system.
  • Your computer meets the minimum system requirements:
    • macOS: macOS Sequoia or later
    • Windows: Windows 10 or later
    • Linux: Ubuntu 24.04 or later
  • You have access to the Ecoscope Desktop installer.

Download the Installer

  1. Download the Ecoscope Desktop installer from app.ecoscope.io/download.
  2. Save the installer to your computer.

The installer file name and format may vary depending on your operating system. Please double-check that you are choosing the right architecture corresponding to your machine’s hardware. Clicking the (?) icon on the download page can help guide you if you’re not sure about the architecture of your machine’s hardware. 

 

 

Install Ecoscope Desktop

  1. Open the downloaded installer file.
  2. Follow the standard installation steps for your operating system.
  3. Once the installation is complete, launch Ecoscope Desktop from your Applications or Programs folder.

When you open the application for the first time, Ecoscope Desktop will guide you through a short onboarding process.

First Launch Onboarding

During the first launch, Ecoscope Desktop walks through a few setup steps to prepare the application for secure data storage and local workflow execution.

The onboarding flow includes three steps:

  1. Welcome
  2. Security setup
  3. Accepting the license agreement

Select Continue to move through each step.

Security Setup

Ecoscope Desktop uses your operating system’s secure storage system to protect sensitive information such as data source credentials. This means credentials are stored using the same security mechanisms your operating system uses for passwords and certificates.

When you continue through the security step, your system may display a Keychain or credential permission dialog.

This is a normal security request that allows Ecoscope Desktop to securely store encrypted credentials.

Important

When the system dialog appears, select Always Allow.

Choosing Always Allow allows Ecoscope Desktop to access its encrypted credential storage without prompting for permission every time the application starts.

Note that this permission only allows Ecoscope Desktop to access information that it has encrypted itself. It will not have access to any other credentials or data that may exist in your system's credential storage or keychain.

If you select Allow or Deny, the application may prompt again for permission the next time it starts. In some cases, you may need to restart the application to complete the setup process. 

Note: The permissions dialog may look different depending on your operating system. On macOS, you will see the Always Allow / Allow / Deny options described above. On Linux, you may see a password prompt instead. On Windows, no dialog appears.

 

Accept the License Agreement

Before using Ecoscope Desktop, you must accept the End User License Agreement (EULA). An internet connection is required to load and view the agreement.

  1. Review the End User License Agreement.
  2. Select the checkbox confirming that you accept the terms.
  3. Click Accept & Start Exploring to continue.

Once accepted, the onboarding process is complete and you will be taken to the Ecoscope Desktop application.

What Happens Next

After the initial setup is complete, you can begin configuring data sources and adding workflow templates.

 

To continue setting up Ecoscope Desktop, see: