diff --git a/README.md b/README.md index b67a08e..257f460 100644 --- a/README.md +++ b/README.md @@ -173,6 +173,23 @@ Here are the steps to follow (e.g. for a `0.1.3` release): You should have a [PyPi](https://pypi.org/) account and be added as an owner/maintainer on the [etherpump package](https://pypi.org/project/etherpump/). +## Testing + +It can be quite handy to run a very temporary local Etherpad instance to test against. This is possible with [Docker](https://docs.docker.com/get-docker/). + +```bash +$ docker run -d --name etherpad -p 9001:9001 etherpad/etherpad +$ docker exec -ti etherpad cat APIKEY.txt;echo +``` + +Then you can `etherpump init` to that local Etherpad for experimentation and testing. You use `http://localhost:9001` as the pad URL. + +Later on, you can remove the Etherpad with: + +```bash +$ docker rm -f --volumes etherpad +``` + ## Maintenance utilities Tools to help things stay tidy over time.