Skip to content
This repository has been archived by the owner on Apr 8, 2021. It is now read-only.

Containerized MediaWiki parsoid service. Supported until June 2021.

License

Notifications You must be signed in to change notification settings

StarCitizenWiki/docker-parsoid

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MediaWiki Parsoid with Docker

Docker Pulls

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

Versions available

scwiki/parsoid:0.12.0

What Is Included?

  • Alpine
  • Parsoid

How to deploy

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

# For MediaWiki >= 1.35
docker run -d -p 8080:8000 -e PARSOID_ENABLE_LINTER=true -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php scwiki/parsoid:0.12.0

Examples

How to add more than one domain:

docker run -d -p 8080:8000 \
            -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 \
            scwiki/parsoid:0.12.0

How to expose on a specific port: (You can use arbitrary port numbers which are not already in use)

# Expose port 8081
docker run -d -p 8081:8000 -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php scwiki/parsoid:0.12.0

# Expose port 8142
docker run -d -p 8142:8000 -e PARSOID_DOMAIN_localhost=http://localhost/w/api.php scwiki/parsoid:0.12.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
  • PARSOID_STRICT_SSL by default true [true, false]
  • PARSOID_ENABLE_LINTER by default false [true, false] - Needed for Extension:DiscussionTools

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.
  • thenets: Maintainer of the second fork.
  • muellermartin: Improved the documentation.
  • endoodev1: Helped with Kubernetes compatibility.
  • sepastian: Added support to strictSSL using container ENV.

About

Containerized MediaWiki parsoid service. Supported until June 2021.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 78.9%
  • Dockerfile 21.1%