Astra’s CLI is a lightweight tool that helps you capture and submit API traffic for security analysis, with minimal setup. To ensure the CLI works reliably across different environments, it is designed to run inside a Docker container.
The CLI internally uses tools such as:
mitmproxy (for intercepting HTTP/S traffic)
OpenTelemetry Collector (for collecting traces and metadata)
These tools have specific system-level dependencies and require controlled runtime conditions. Docker allows us to bundle all of this into a single container, ensuring consistent performance and avoiding conflicts with software on your local machine.
With Docker, you don’t need to install mitmproxy, OpenTelemetry, or manage Python environments and library versions manually. The CLI works out-of-the-box with just Docker installed, reducing setup time and making it easier to keep things up to date.
Some features of the CLI—such as traffic capture via proxy—require specific network routing and port configurations. Docker provides a controlled environment where we can ensure these networking requirements are handled predictably across systems and platforms.
The CLI is designed to support multiple workflows for collecting API traffic, such as:
Setting up a proxy to capture live traffic
Importing traffic from tools like Burp Suite
These features are designed to work seamlessly within the Dockerized environment.
If Docker isn’t available in your environment, reach out to our support team. We’re happy to help you explore alternative approaches for submitting API traffic securely.
Docker enables the CLI to function in a consistent, secure, and portable way - without requiring deep technical setup on your end. It helps us deliver a smooth experience while using advanced tooling under the hood.
For any issues or assistance with setup, feel free to contact our support team.