Shifter - Local
Docker image for testing WordPress themes and plugins while migrating to Shifter. This image is also available on Dockerhub.
git clone https://github.com/getshifter/shifter-local.git
docker-compose up -d
Visit https://127.0.0.1:8443 in your browser.
Ctl + C in your terminal window to stop running containers.
Considering file permissions, we recommend using volumes on Linux.
docker-compose -f docker-compose.yml -f docker-compose_linux.yml up
Updating Docker Image
- Linux (detect path using
docker volume inspect)
All data will be persisted in these directories, even if the Docker containers are stopped.
To start over with the installation, simply delete
docker volume rm.
Some plugins and themes may conflict with Shifter. Conflicts usually cause the Generator to hang or fail. Here are a few tips.
Check for a valid JSON format
Your site should return a list of valid URLs in JSON format for Shifter to crawl for generating.
?url=0 to the websites URL to test.
Check for list of all target pages
If the number of pages to be generated is more than 100, you can check the target by 100 pages by increasing the number of the urls parameter. (e.g. urls=1, urls=2)
Pages that do not appear in this list are not subject to generate.
Common problems and solutions when there are no pages in the list are as follows.
- pagination issues. (Work in progress)
Displaying PHP Errors
While running your site on Shifters production environment PHP warning are suppressed. These warning if any are visible while running Shifter-Local for debugging your theme.
- Depending on your local environment mail functions may send from this container. Example: Under
Outbound Port 25 Blocking
This Docker image is similar to the one used by Shifter, but does not guarantee complete compatibility.