gared/ether-scan

A simple scanner for Etherpad instances

v3.5.0 2026-03-27 12:45 UTC

Requires

• php: >=8.3
• ext-json: *
• elephantio/elephant.io: 5.1.*
• guzzlehttp/guzzle: ^7.8
• symfony/console: ^6.4|^7.0

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^12.5

Apache-2.0

README

Use this tool to scan your etherpad instance to get some insights and test if there is any misconfiguration.

What is this tool doing?

• Check the "Server" header to see if the revision of etherpad is returned
• Check the API version (pad.example.com/api)
• Check the etherpad version
• Check if the pads are publicly accessible
• Check if the server is healthy (pad.example.com/health)
• Check if the admin area is accessible with default credentials (pad.example.com/admin)
• Check if any (frontend) plugins are installed
• Check if the server is running since a long time (pad.example.com/stats)

Try it out

You can try this tool out on the https://scanner.etherpad.org which is using this library.

Requirements

You need PHP 8.3 or higher to run this tool.

Usage

Docker

Directly download and run this docker image to scan your instance

docker run --rm gared/ether-scan:main bin/console.php ether:scan http://localhost:9001

Clone

Clone this repository and install dependencies

composer install

Next run this command to scan your instance

bin/console.php ether:scan http://localhost:9001

Composer

You can also install this tool with composer

composer require gared/ether-scan