{"id":16366529,"url":"https://github.com/centminmod/docker-ubuntu-locust","last_synced_at":"2026-04-17T06:33:45.163Z","repository":{"id":80279768,"uuid":"96382484","full_name":"centminmod/docker-ubuntu-locust","owner":"centminmod","description":"Docker image for locust.io load testing","archived":false,"fork":false,"pushed_at":"2017-07-06T10:41:29.000Z","size":63,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-03T04:43:22.173Z","etag":null,"topics":["docker","locust","locust-docker","locustio","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/centminmod.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-07-06T03:01:32.000Z","updated_at":"2017-10-04T12:28:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"5f093cd5-8729-48ea-818d-dec7b8d60582","html_url":"https://github.com/centminmod/docker-ubuntu-locust","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/centminmod/docker-ubuntu-locust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centminmod%2Fdocker-ubuntu-locust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centminmod%2Fdocker-ubuntu-locust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centminmod%2Fdocker-ubuntu-locust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centminmod%2Fdocker-ubuntu-locust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/centminmod","download_url":"https://codeload.github.com/centminmod/docker-ubuntu-locust/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/centminmod%2Fdocker-ubuntu-locust/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31918621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","locust","locust-docker","locustio","ubuntu"],"created_at":"2024-10-11T02:46:49.191Z","updated_at":"2026-04-17T06:33:45.145Z","avatar_url":"https://github.com/centminmod.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-ubuntu-locust\n\n[![](https://images.microbadger.com/badges/version/centminmod/docker-ubuntu-locust.svg)](https://microbadger.com/images/centminmod/docker-ubuntu-locust \"Get your own version badge on microbadger.com\") [![](https://images.microbadger.com/badges/image/centminmod/docker-ubuntu-locust.svg)](https://microbadger.com/images/centminmod/docker-ubuntu-locust \"Get your own image badge on microbadger.com\") [![](https://images.microbadger.com/badges/commit/centminmod/docker-ubuntu-locust.svg)](https://microbadger.com/images/centminmod/docker-ubuntu-locust \"Get your own commit badge on microbadger.com\")\n\nDocker image for [locust.io](http://locust.io). [Locust Documentation](http://docs.locust.io/).\n\nPreviously tested Locust.io\n\n* [Wordpress7 Locust.io Load Testing (Dec 2014)](http://wordpress7.centminmod.com/132/wordpress-super-cache-benchmark-locust-io-load-testing/)\n\n![](images/locust-01.png)\n\n# standalone\n\nwhere `TARGET_URL` is the site domain name you want to test i.e. `TARGET_URL=http://domain.com`. Setup `target` variable.\n\n    target=http://domain.com\n    docker run -d -p 8089:8089 --name locust -e LOCUST_MODE=standalone -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\nuse native host network to lower network overhead\n\n    target=http://domain.com\n    docker run -d -p 8089:8089 --net=host --name locust -e LOCUST_MODE=standalone -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\n# distributed\n\n**master**\n\nwhere `TARGET_URL` is the site domain name you want to test i.e. `TARGET_URL=http://domain.com`\n\n    target=http://domain.com\n    docker run -d -p 8089:8089 --name locustmaster -e LOCUST_MODE=master -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\nuse native host network to lower network overhead\n\n    target=http://domain.com\n    docker run -d -p 8089:8089 --net=host --name locustmaster -e LOCUST_MODE=master -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\n**slave**\n\nWhere `\u003cmaster-server-ip` is IP address for locust.io master assigned to variable `masterhost` and `TARGET_URL` is the site domain name you want to test i.e. `TARGET_URL=${target}` and first slave named `--name locustslave1`. For second slave name `--name locustslave2`, third slave name `--name locustslave3` etc.\n\n    target=http://domain.com\n    masterhost=\u003cmaster-server-ip\u003e\n    docker run -d -p 8090:8089 --name locustslave1 -e LOCUST_MODE=slave -e MASTER_HOST=${masterhost} -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\nuse native host network to lower network overhead\n\n    target=http://domain.com\n    masterhost=\u003cmaster-server-ip\u003e\n    docker run -d -p 8090:8089 --net=host --name locustslave1 -e LOCUST_MODE=slave -e MASTER_HOST=${masterhost} -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\n**slave scripting**\n\nyou can script starting X number of slaves i.e. start 3 slave instances with sequence 1, 2, 3.\n\n    for i in $(seq 1 3); do\n      port=8089\n      port=$(($port+$i))\n      target=http://domain.com\n      masterhost=\u003cmaster-server-ip\u003e\n      docker run -d -p $port:8089 --name locustslave${i} -e LOCUST_MODE=slave -e MASTER_HOST=${masterhost} -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n    done\n\nremoval of the locust slaves\n\n    for i in $(seq 1 3); do\n      docker stop locustslave${i}; docker rm locustslave${i};\n    done\n\nremoval of locust master\n\n    docker stop locustmaster; docker rm locustmaster\n\nexample of 1x master + 3x slave locust.io configuration\n\n![](images/locust-04.png)\n\n# inspecting logs\n\n    docker logs locust -f\n\nexample run for named `locust` image:\n\n    target=http://domain.com\n    docker run -d -p 8089:8089 --name locust -e LOCUST_MODE=standalone -e TARGET_URL=${target} centminmod/docker-ubuntu-locust\n\nexample run log inspection for docker image named `locust`\n\n    docker logs locust -f\n    =\u003e Starting locust\n    /usr/local/bin/locust -f /locust/scripts/locust0.py --host=http://domain.com\n    [2017-07-06 03:43:59,718] 9ba173c41ae7/INFO/locust.main: Starting web monitor at *:8089\n    [2017-07-06 03:43:59,718] 9ba173c41ae7/INFO/locust.main: Starting Locust 0.7.5\n    [2017-07-06 03:45:25,073] 9ba173c41ae7/INFO/locust.runners: Hatching and swarming 1000 clients at the rate 100 clients/s...\n    [2017-07-06 03:45:42,760] 9ba173c41ae7/INFO/locust.runners: All locusts hatched: MyLocust: 1000\n    [2017-07-06 03:45:42,760] 9ba173c41ae7/INFO/locust.runners: Resetting stats\n\n![](images/locust-02.png)\n\n# tips\n\nsetup a SSH alias commands\n\nto remove docker image `locust` standalone\n\n    alias rmlocust='docker stop locust; docker rm locust; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustmaster` master\n\n    alias rmlocustmaster='docker stop locustmaster; docker rm locustmaster; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave1` slave `#1`\n\n    alias rmlocustslave1='docker stop locustslave1; docker rm locustslave1; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave2` slave `#2`\n\n    alias rmlocustslave2='docker stop locustslave2; docker rm locustslave2; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave3` slave `#3`\n\n    alias rmlocustslave3='docker stop locustslave3; docker rm locustslave3; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave4` slave `#4`\n\n    alias rmlocustslave4='docker stop locustslave4; docker rm locustslave4; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave5` slave `#5`\n\n    alias rmlocustslave5='docker stop locustslave5; docker rm locustslave5; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave6` slave `#6`\n\n    alias rmlocustslave6='docker stop locustslave6; docker rm locustslave6; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave7` slave `#7`\n\n    alias rmlocustslave7='docker stop locustslave7; docker rm locustslave7; docker rmi centminmod/docker-ubuntu-locust;'\n\nto remove docker image `locustslave8` slave `#8`\n\n    alias rmlocustslave8='docker stop locustslave8; docker rm locustslave8; docker rmi centminmod/docker-ubuntu-locust;'","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentminmod%2Fdocker-ubuntu-locust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcentminmod%2Fdocker-ubuntu-locust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcentminmod%2Fdocker-ubuntu-locust/lists"}