Install

The logship agent OCI container is hosted on the GitHub Container Registry.

docker pull ghcr.io/logship-io/logship-agent:latest

Native installation

Standalone agent binaries are published on GitHub Releases:

For a full local Logship install on a single Linux host, use the deployment installer:

curl -fsSL https://raw.githubusercontent.com/logship-io/logship-deployments/main/src/shell/install.sh | sh

Quick start

docker run -d --name logship-agent \
  --network host \
  -v $PWD/agent-config.json:/app/appsettings.json:ro \
  ghcr.io/logship-io/logship-agent:latest
# Mount your appsettings.json to configure outputs and inputs.
# When not using host networking, expose any UDP ports you configure (e.g., -p 49999:49999/udp).

# Download the latest ZIP release and unzip.
# Place appsettings.json next to Logship.Agent.ConsoleHost.exe, then:
New-Service -Name "logship.agent" -BinaryPathName "C:\logship\Logship.Agent.ConsoleHost.exe" -DisplayName "Logship Agent" -StartupType Automatic
Start-Service -Name "logship.agent"
# Check status:
Get-Service -Name "logship.agent"

wget https://github.com/logship-io/logship-agent/releases/latest/download/LogshipAgent-linux-x64.zip -O logship-agent.zip
unzip logship-agent.zip -d logship-agent
cd logship-agent
# Place appsettings.json next to Logship.Agent.ConsoleHost, then run:
./Logship.Agent.ConsoleHost

Upgrade

Container: pull the new tag and restart.
Native: stop the service, replace binaries, start the service. Preserve your config file.