Skip to main content
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>
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:
1

User & Group Creation

Creates a dedicated simob user and group for security isolation
2

Binary Download

Downloads the latest agent binary for your system architecture
3

Service Setup

Configures and enables a systemd service for automatic startup
4

Agent Initialization

Runs the initial configuration with your provided server key
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:
1

Build the Binary

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

Download Install Script

Download the installation script:
curl -fsSL https://simpleobservability.com/install.sh -o install.sh
3

Install with Custom Binary

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