cybernick/parsoid repository overview

⁠Docker image of Parsoid for MediaWiki

This repo contains a Docker⁠ image to run the Parsoid⁠ application. See the full Parsoid/Setup documentation⁠ for help.

And this repo was base on this repo⁠ with little modifications and basically build to use Parsoid with this MediaWiki docker repo⁠ both in docker.

⁠Tags

• latest docker image tag is master branch of Parsoid repo
• 0.X.0 docker image tag is v0.X.0 tag of Parsoid repo

⁠How to deploy

To start Parsoid⁠ standalone run the command below. Just pay attention to the MediaWiki version and choose a compatible Parsoid version.

# For MediaWiki = 1.31 and Parsoid build 0.9.0
docker run -it -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php cybernick/parsoid:0.9.0

# For MediaWiki >= 1.31 and Parsoid build 0.10.0
docker run -it -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php cybernick/parsoid:0.10.0

Pay attention to connect parsoid container with your MediaWiki container

⁠Examples

How to add more than one domain:

docker run -it -p 8080:80 \
            -e PARSOID_DOMAIN_foobar=http://foobar.com/w/api.php \
            -e PARSOID_DOMAIN_example=http://example.com/w/api.php \
            -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php \
            cybernick/parsoid:0.10.0

⁠Settings (ENV vars)

• PARSOID_DOMAIN_{domain} defines URI and domain for the Parsoid service. The value of {domain} should be the same as the MW_REST_DOMAIN parameter in the MediaWiki web container. You can specify such variables multiple times (one for each domain the service should run for)
• PARSOID_NUM_WORKERS defines the number of worker processes to the parsoid service. Set to 0 to run everything in a single process without clustering. Use ncpu to run as many workers as there are CPU units.
• PARSOID_LOGGING_LEVEL by default info

For example, the environment variable PARSOID_DOMAIN_web=http://web/w/api.php creates following section in the Parsoid configuration:

mwApis:
  -
    uri: 'http://web/w/api.php'
    domain: 'web'

⁠Thanks

• pastakhov⁠: Creator of the original code base.
• muellermartin⁠: Improved the documentation.
• thenets⁠ Creator of forked version