Sign inSign up

onepam/agent

By onepam

Updated 5 months ago

OnePAM Agent — lightweight zero-trust agent for secure remote access and secret management

Image
Networking
Security
0

279

onepam/agent repository overview

OnePAM Agent

Lightweight zero-trust agent for target servers.

The OnePAM Agent runs on servers you want to manage. It provides secure SSH access, HTTP tunneling, secret management, and asset discovery — all controlled from the OnePAM console with full session recording and audit logging.

Quick Start

docker run -d --name onepam-agent \
  --restart unless-stopped \
  -e ONEPAM_SERVER=https://onepam.com \
  -e ONEPAM_TENANT_ID=your-tenant-id \
  onepam/agent:latest

Features

FeatureDescription
Secure SSHBuilt-in SSH server with session recording
HTTP TunnelReverse tunnel for web application access
Secret ManagementLocal secret store synced to OnePAM vault
Asset DiscoveryAutomatic discovery of services and ports
Auto-UpdateSelf-updating binary with zero downtime
mTLSMutual TLS authentication to gateway
Audit LoggingAll actions logged and shipped to control plane
Systemd IntegrationWatchdog, ready notification, journal logging

Configuration

VariableDescriptionDefault
ONEPAM_SERVEROnePAM control plane URL(required)
ONEPAM_TENANT_IDTenant identifier(required)
AGENT_DATA_DIRPersistent data directory/app/data

How It Works

┌─────────────┐       ┌──────────────────┐       ┌──────────────┐
│  OnePAM     │◄─WSS─►│  OnePAM Gateway  │◄─mTLS─►│ OnePAM      │
│  Console    │       │                  │        │ Agent        │
└─────────────┘       └──────────────────┘        │ (this image) │
                                                  │              │
                                                  │ ┌──────────┐ │
                                                  │ │ SSH      │ │
                                                  │ │ Secrets  │ │
                                                  │ │ Tunnel   │ │
                                                  │ │ Discover │ │
                                                  │ └──────────┘ │
                                                  └──────────────┘

Image Details

  • Base: Alpine Linux (minimal footprint)
  • Size: ~30 MB (UPX compressed)
  • User: Runs as non-root where possible
  • Healthcheck: Built-in --healthcheck flag

Native Installation

For production workloads, install the agent natively (without Docker):

curl -fsSL https://updates.onepam.com/scripts/install.sh | bash

Supports Linux amd64, arm64, armv7, and i386.

Documentation

Full documentation: https://onepam.com/docs

License

Proprietary — https://onepam.com/terms

Tag summary

Content type

Image

Digest

sha256:58f0bde8b

Size

25.6 MB

Last updated

5 months ago

docker pull onepam/agent