 Installation

EdgeSet can run either as a single-user desktop application or as a multi-user web application.

Desktop Application

Note that the desktop application is a standalone EdgeSet installation: it does not require or support connecting to the web application. It is intended for use when the web application cannot be installed.

Requirements

• macOS 13+¹
• 12GB of free disk space
• EdgeSet license key
• internet connection

¹ The desktop application is tested on Apple Silicon Macs only, not Intel Macs.

Installation

1. Download EdgeSet from https://www.tetmon.com/EdgeSet.dmg.

2. Open your Downloads folder and double-click the EdgeSet.dmg file.

the EdgeSet.dmg file in the Downloads folder

3. Drag the EdgeSet icon to the Applications folder.

the EdgeSet installation folder

4. Open the EdgeSet application from the Applications folder.

EdgeSet in the Applications folder

5. When you first start EdgeSet, you might see the following prompt. Click Open to proceed.

macOS prompt that EdgeSet has been downloaded from the internet

6. During installation and whenever you launch EdgeSet, you might be prompted to allow EdgeSet access to the keychain. EdgeSet will only access data that it stores on the keychain itself. Select Always Allow.²

² EdgeSet uses the macOS keychain to store credentials in order to protect your data from other applications on the system.

macOS keychain prompt

7. EdgeSet will begin downloading the query engine. This is a one-time setup.

EdgeSet query engine download progress

8. Once the query engine download is complete, EdgeSet will start up.

EdgeSet startup message

9. The first time EdgeSet starts, it will prompt you for your license key.

EdgeSet upload license key dialog

10. Click Upload license file… and Open the license.key file you were provided.

browse to EdgeSet license key

11. EdgeSet will show a brief loading screen with progress indicator while it generates an encryption key. Then the EdgeSet interface will appear and you are ready to begin adding data sources.

the EdgeSet interface

Uninstallation

1. To uninstall EdgeSet, move the EdgeSet Application to the Trash.

move the EdgeSet Application to the Trash

2. Open the ~/Library/Application Support folder and move the EdgeSet folder there into the Trash (this is the folder that holds the query engine).³

³ To easily navigate to the Application Support folder from the Finder, you can press ⌘Command + Shift + G and type in ~/Library/Application Support.

move the EdgeSet Application Support folder to the Trash

Web Application

Requirements

EdgeSet is designed to run on-premise or in a private cloud. You can install it on a physical server (“bare metal”) or a VM (such as from AWS, Azure, Digital Ocean, etc.).

EdgeSet requires a 64-bit Intel-compatible (x86-64) or ARM64 (aarch64) CPU.

Minimum system requirements

Concurrent query slots	Memory	CPU Cores	Disk
2	8GB	2	16GB
5	12GB	4	20GB
15	24GB	12	30GB
50	64GB	32	60GB

EdgeSet also requires UEFI support.⁴

⁴ Most computers since 2006 have UEFI support.

Amazon Web Services (AWS)

Launch an EC2 instance using the EdgeSet AMI ID provided to you.

Google Cloud Platform (GCP)

Launch a GCE instance using the qcow2 disk image (x86_64 or arm64).

Digital Ocean

Import the qcow2 disk image (x86_64 or arm64) to your DigitalOcean account as a “Custom Image” (see https://www.digitalocean.com/blog/custom-images/). Launch a droplet with the custom image.

Hetzner Cloud

Import the raw disk image (x86_64 or arm64) as a snapshot (i.e. using hcloud-upload-image). Launch a new VM with the snapshot.