{"id":28746158,"url":"https://github.com/ether/etherpad-load-test","last_synced_at":"2026-03-14T18:54:46.506Z","repository":{"id":39796965,"uuid":"30893837","full_name":"ether/etherpad-load-test","owner":"ether","description":"CLI tool to simulate pad user load on an Etherpad Instance","archived":false,"fork":false,"pushed_at":"2024-05-08T13:32:15.000Z","size":790,"stargazers_count":6,"open_issues_count":8,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-06-06T02:48:24.063Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ether.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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}},"created_at":"2015-02-16T23:28:13.000Z","updated_at":"2025-02-06T00:37:44.000Z","dependencies_parsed_at":"2024-03-12T22:24:41.027Z","dependency_job_id":"2b3a2251-cff4-483b-a48d-7295d34fd514","html_url":"https://github.com/ether/etherpad-load-test","commit_stats":{"total_commits":106,"total_committers":5,"mean_commits":21.2,"dds":0.2547169811320755,"last_synced_commit":"2caadb5b20120dd4012baca2699e7417160be805"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/ether/etherpad-load-test","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fetherpad-load-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fetherpad-load-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fetherpad-load-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fetherpad-load-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ether","download_url":"https://codeload.github.com/ether/etherpad-load-test/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fetherpad-load-test/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259827731,"owners_count":22917727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-06-16T14:30:35.553Z","updated_at":"2026-03-14T18:54:41.482Z","avatar_url":"https://github.com/ether.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Publish Status](https://github.com/ether/etherpad-load-test/workflows/Node.js%20Package/badge.svg) ![Backend Tests Status](https://github.com/ether/etherpad-load-test/workflows/Backend%20tests/badge.svg)\n\n# Etherpad Loadtest\n## Setup\n1. Enable Load Testing in your Etherpad ``settings.json`` by setting ``\"loadTest\":true``.\n2. Reload Etherpad instance.\n3. Install etherpad-load-test globally via ``npm install -g etherpad-load-test``.\n4. Use etherpad-loadtest command (cf. Usage).\n\n(**Important:** Don't forget to set ``\"loadTest\":false`` afterwards)\n\n## Usage\n\n``etherpad-loadtest [\u003curl\u003e -l \u003cnum-lurkers\u003e -a \u003cnum-active-authors\u003e -d \u003cduration\u003e]``\n\nBasic load test will increase # of lurkers and authors every 5 seconds until changesets are stopped processing in a timely fashion.\nAt this point the # of lurkers and authors tells the admin how many people could use their instance.  Roughly.  Take into account as documents grow they have heavier computing costs.  \n\nYou should modify your tests to your use case.\n\n### Parameters\n``-l`` number of lurkers.\n\n``-a`` number of active authors.\n\n``-d`` duration in seconds to test for. Default is unlimited.\n\n### Examples\n- ``etherpad-loadtest``(Basic Example, url defaults to http://127.0.0.1:9001)\n- ``etherpad-loadtest http://127.0.0.1:9001`` (Test specific Etherpad instance)\n- ``etherpad-loadtest http://127.0.0.1:9001/p/test`` (Test specific Pad)\n- ``etherpad-loadtest -d 60`` (Test for 60 seconds)\n- ``etherpad-loadtest -l 50 -a 10`` (Test with 50 lurkers and 10 authors)\n\n### Testing multiple pads at once\n``etherpad-loadtest-multi [\u003cnum of pads\u003e]`` (default is 10 pads)\n\n(Example: ``etherpad-loadtest-multi 10``)\n\nThe above command will put 3 authors on 10 pads for 30 seconds. This creates a total of 30 authors.\n\n## Test Results\n* On a reasonable machine you can expect 40 authors on one pad. (-a 40)\n* On a reasonable machine you can expect to achieve around 3 authors on 200 pads [node multi.js 200]. \n\nNote that most authors will not contribute as agressively as our logic here, we implement max(worst case) user load testing.\nIf you hit limitations, remember etherpad-proxy is a thing to rewrite to multiple backend instances 🔥\n\n*TODO/Note:* Citation and test results needed.\n\n## License\nApache 2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fether%2Fetherpad-load-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fether%2Fetherpad-load-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fether%2Fetherpad-load-test/lists"}