From 16cb8499ceca8e2d9cd4000c47779201d2a3370c Mon Sep 17 00:00:00 2001 From: Aykhan Shahsuvarov Date: Fri, 26 Jul 2024 00:04:26 +0400 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20Update=20README.md=20with=20Dock?= =?UTF-8?q?er=20installation=20instructions?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b3dc039..4cc7901 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,19 @@

## Installation +### With Docker (Recommended) +Pull the Dodo image from Docker Hub: +```sh +docker pull aykhans/dodo:latest +``` +If you use Dodo with Docker and a config file, you must provide the config.json file as a volume to the Docker run command (not as the "-c config.json" argument), as shown in the examples in the [usage](#usage) section. + +### With Binary File You can grab binaries in the [releases](https://github.com/aykhans/dodo/releases) section. ### Build from Source -To build Dodo from source, you need to have [Go1.22+](https://golang.org/dl/) installed. Follow the steps below: +To build Dodo from source, you need to have [Go1.22+](https://golang.org/dl/) installed.
+Follow the steps below to build dodo: 1. **Clone the repository:** @@ -38,6 +47,10 @@ Send 1000 GET requests to https://example.com with 10 parallel dodos (threads) a ```sh dodo -u https://example.com -m GET -d 10 -r 1000 -t 2000 ``` +With Docker: +```sh +docker run --rm aykhans/dodo -u https://example.com -m GET -d 10 -r 1000 -t 2000 +``` ### 2. JSON config file You can find an example config structure in the [config.json](https://github.com/aykhans/dodo/blob/main/config.json) file: @@ -69,6 +82,10 @@ Send 1000 GET requests to https://example.com with 5 parallel dodos (threads) an ```sh dodo -c /path/config.json ``` +With Docker: +```sh +docker run --rm -v ./path/config.json:/dodo/config.json -i aykhans/dodo +``` ### 3. Both (CLI & JSON) Override the config file arguments with CLI arguments: @@ -76,6 +93,10 @@ Override the config file arguments with CLI arguments: ```sh dodo -c /path/config.json -u https://example.com -m GET -d 10 -r 1000 -t 2000 ``` +With Docker: +```sh +docker run --rm -v ./path/config.json:/dodo/config.json -i aykhans/dodo -u https://example.com -m GET -d 10 -r 1000 -t 2000 +``` ## CLI and JSON Config Parameters | Parameter | JSON config file | CLI Flag | CLI Short Flag | Type | Description | Default | @@ -93,5 +114,4 @@ dodo -c /path/config.json -u https://example.com -m GET -d 10 -r 1000 -t 2000 | Proxy | proxies | - | - | List[Key-Value {string: string}] | List of proxies (will check active proxies before sending requests) | - | ## Examples -![dodo_example](https://raw.githubusercontent.com/aykhans/dodo/main/assets/dodo-example.gif) - +![dodo_example](https://raw.githubusercontent.com/aykhans/dodo/main/assets/dodo-example.gif) \ No newline at end of file