Installation

The Simple Observability agent can be installed using prebuilt binaries or built from source. The prebuilt binary installation is the recommended approach for most users.

Prebuilt Binaries

You can install the agent with a single command:

curl -fsSL https://simpleobservability.com/install.sh | sudo bash -s -- <SERVER_KEY>

Note

Replace <SERVER_KEY> with the server key from your simpleobservability.com account.

What the install script does

The installation script automatically handles the complete setup process:

Creates a dedicated simob user and group for security isolation
Downloads the latest agent binary for your system architecture
Configures and enables a systemd service for automatic startup
Runs the initial configuration with your provided server key

Info

The install script is fully documented with verbose comments and is designed to be easy to read, understand, and audit before execution.

Building from Source

If you prefer to build the agent yourself or need a custom build:

Build the agent binary:
```
  go build -o <PATH_TO_BINARY> main.go
```

Download the installation script:

curl -fsSL https://simpleobservability.com/install.sh -o install.sh

Set the BINARY_PATH environment variable to point to your built binary:
```
sudo BINARY_PATH=<PATH_TO_BINARY> bash install.sh <SERVER_KEY>
```

Verification

After installation, verify the agent is running:

simob status

simob version