ddosify/ddosify-docker-extension repository overview

⁠ Ddosify Docker Extension

High-performance load testing tool for Docker Desktop

⁠Features

⁠Installation

⁠Docker Extensions Marketplace (Recommended)

1. Open Docker Desktop (version 4.10 or higher required)
2. Navigate to the Extensions tab
3. Click Add Extensions
4. Search for Ddosify and click Install

⁠Terminal

# Install from Docker Hub
docker extension install ddosify/ddosify-docker-extension:latest

# Or build and install locally
docker build --tag=ddosify/ddosify-docker-extension:latest .
docker extension install ddosify/ddosify-docker-extension:latest

⁠Usage

⁠Basic Load Test

1. Enter your target URL (e.g., httpbingo.org/get)
2. Select the protocol (HTTP/HTTPS) and HTTP method
3. Configure load parameters:
   • Request Count: Total number of requests
   • Duration: Test duration in seconds
   • Load Type: Linear, Incremental, or Waved
4. Click Start to run the test

⁠Debug Mode

Click Debug to send a single request with verbose output - useful for verifying your configuration before running a full load test.

⁠CLI Command Export

Click the terminal icon to view and copy the equivalent Docker CLI command:

docker run -it --rm ddosify/ddosify ddosify -t "https://httpbingo.org/get" -n 100 -d 10 -m GET -l linear -T 5

⁠Advanced Options

• Headers: Add custom HTTP headers
• Request Body: Send JSON or other data with POST/PUT requests
• Basic Auth: Add authentication credentials
• Proxy: Route requests through a proxy server
• Timeout: Set request timeout in seconds

⁠Dynamic Variables

Use dynamic variables in your URL, headers, or body:

Example: https://api.example.com/users/{{_randomInt}}

See Ddosify documentation⁠ for the full list of dynamic variables.

⁠Tips

• Use host.docker.internal instead of localhost to test services running on your host machine
• Start with Debug mode to verify your configuration
• Use the PDF report feature to save and share test results

⁠Development

⁠Setup

cd ui
npm install
npm run dev

⁠Debug with Hot Reload

docker extension dev debug ddosify/ddosify-docker-extension
docker extension dev ui-source ddosify/ddosify-docker-extension http://localhost:3000

⁠Build

npm run build
docker build --tag=ddosify/ddosify-docker-extension:dev .
docker extension install ddosify/ddosify-docker-extension:dev

⁠Reset Configuration

docker extension dev reset ddosify/ddosify-docker-extension

⁠Uninstall

docker extension rm ddosify/ddosify-docker-extension:latest

⁠Publishing to Marketplace

To publish a new version to the Docker Extensions Marketplace⁠:

⁠1. Update Version

Update the TAG in the Makefile:

TAG?=0.3.0

⁠2. Build and Push Multi-arch Image

make push-extension

This builds and pushes images for both linux/amd64 and linux/arm64 platforms.

⁠4. Automatic Publishing

Extensions now go through an automated validation process. If all checks pass, the extension is published within a few hours. No manual review is required.

⁠Notes

• The marketplace caches extensions for 12 hours. Restart Docker Desktop to force refresh.
• Only extensions listed in the marketplace can be installed by default (changeable in Docker Desktop settings).
• Extension updates are automatically downloaded and installed for users.

For more details, see the Docker Extensions Publishing Guide⁠.

⁠Community

• Join our Discord Server⁠ for support, feature requests, and discussions
• Star the Ddosify repository⁠ on GitHub
• Report issues on GitHub Issues⁠

⁠More

This extension uses the single-node version of Ddosify. For distributed, no-code, and geo-targeted load testing, check out Ddosify Cloud⁠.

⁠Disclaimer

Ddosify is created for testing the performance of web applications. Users must be the owner of the target system. Using it for harmful purposes is strictly prohibited. The Ddosify team & company is not responsible for misuse or its consequences.

⁠Note

Ddosify has been renamed to Anteon⁠. The load testing engine remains open source and continues to be maintained.

⁠License

Licensed under the AGPLv3⁠