ftagent-docker

Docker packaging for ftagent, the Flowtriq DDoS detection agent. Provides real-time traffic monitoring, attack detection, PCAP capture, and auto-mitigation for Linux servers running in containerized environments.

A valid Flowtriq account and API key are required. Start a free 14-day trial at flowtriq.com.

---

Quick Start

docker run -d \
--name ftagent \
--network host \
--cap-add NET_RAW \
--cap-add NET_ADMIN \
-e FTAGENT_API_KEY=your_api_key \
-e FTAGENT_NODE_UUID=your_node_uuid \
flowtriq/ftagent

Docker Compose

services:
ftagent:
image: flowtriq/ftagent:latestcontainer_name: ftagentrestart: unless-stoppednetwork_mode: hostcap_add:
- NET_RAW
- NET_ADMINenvironment:
- FTAGENT_API_KEY=your_api_key
- FTAGENT_NODE_UUID=your_node_uuid
- FTAGENT_INTERFACE=eth0volumes:
- ftagent-data:/var/lib/ftagent
- ftagent-logs:/var/log/ftagentvolumes:
ftagent-data:
ftagent-logs:

A ready-to-use docker-compose.yml is included in this repository. Copy .env.example or set the environment variables directly.

Environment Variables

Variable	Required	Default	Description
FTAGENT_API_KEY	Yes	--	Your Flowtriq API key
FTAGENT_NODE_UUID	Yes	--	Node UUID from your Flowtriq dashboard
FTAGENT_INTERFACE	No	eth0	Network interface to monitor
FTAGENT_API_URL	No	https://api.flowtriq.com	API endpoint

Config File Mount

Alternatively, mount your own config file instead of using environment variables:

docker run -d \
--name ftagent \
--network host \
--cap-add NET_RAW \
--cap-add NET_ADMIN \
-v /path/to/config.json:/etc/ftagent/config.json \
flowtriq/ftagent

Requirements

• --network host is required for the agent to see real network traffic
• NET_RAW and NET_ADMIN capabilities are required for packet capture
• A Flowtriq account with an API key and Node UUID

Getting Your API Key

1. Sign up at flowtriq.com
2. Go to Dashboard > Nodes > Add Node
3. Copy the API key and Node UUID

Image Tags

• latest -- latest stable release
• x.y.z -- specific version (e.g., 1.9.10)

Building Locally

git clone https://github.com/Flowtriq/ftagent-docker.git
cd ftagent-docker
docker build -t ftagent .

Links

• Flowtriq Website
• ftagent on GitHub
• Documentation
• Support

License

MIT License. See LICENSE for details.