SolutionEngine LogoSolutionEngine
HomeProductUse CasesPricing

Environment Setup and Agent Install

This page covers first-time environment setup for cloud-edge execution.

Step 1: Create Environment Record

In project environments UI, create an environment with:

  • clear name (location + purpose)
  • environment type (edge/on-prem where applicable)
  • connection notes for operations

Do not reuse one environment entry across multiple physical devices.

Step 2: Capture Environment ID

After creation, copy the generated environment ID.

This ID binds the runtime agent to the correct project target.

Step 3: Install Agent Container

Run the environment agent in Docker with restart policy enabled.

Typical command pattern:

docker run -d \
  --name solutionengine-agent \
  --restart unless-stopped \
  -e ENV_ID=<environment_id> \
  -e API_URL=<platform_api_url> \
  -e AUTH_TOKEN=<scoped_token> \
  solutionengine/solutionengine_agent:latest

Required Runtime Settings

VariableRequiredPurpose
ENV_IDYesBinds agent to target environment
API_URLYesPlatform API endpoint
AUTH_TOKENYesAgent authentication
SYNC_INTERVALOptionalWorkflow sync cadence
HEARTBEAT_INTERVALOptionalHealth reporting cadence

Validation Checklist

  • Container is running (docker ps)
  • First heartbeat appears in environment status
  • Environment status changes to online
  • Assigned workflows synchronize successfully

Common Setup Failures

  • Wrong environment ID
  • Invalid token/scope
  • API endpoint unreachable from target network
  • Container restarted repeatedly due to missing env vars

Related Pages

PreviousBucket Media Storage
NextAgent Tools