Troubleshooting WPLib Box¶
Please Report the Issue on GitHub¶
Even if you do find a solution, please report the issue...
Even if you do find a solution please report the issue so we can either fix it or document it to make using WPLib Box easier for everyone.
If your browser times out¶
This in our most common issue
If you have WPLib Box installed more than once for the same local domain
name it will unfortunately not load. And as long as we are still
using Vagrant this will continue to be a problem. Fortunately, we will be
off Vagrant soon enough.
If your browser times-out trying to load wplib.box check your hosts file to see if you have more than one IP address entry mapped to the
and its various subdomains.
Trouble with VirtualBox¶
If you have problems installing or running VirtualBox
First, try Googling the error messages you get when trying to install. VirtualBox is independent of WPLib Box and thus you will often find solutions online.
Problems with Vagrant¶
If Vagrant is giving you trouble
vagrant up --debug to see if it can reveal any issues with your system that you are able to correct. You may want to redirect to a debug log so you can read the output in your text editor:
vagrant up --debug > vagrant.log 2>&1
If you can't find the solution to your problem using the
please provide your
vagrant.log via Slack or GitHub or email at
firstname.lastname@example.org when requesting help.
Nothing Here Solved Your Problem¶
If you did not find your answer in any of the items listed
If you do not find a solution, join our Slack to get help
from our team in the
Don't be shy, we really do want to hear from you as it will help us make your experience with WPLib Box and everyone else's much better.
If your problem is Vagrant-related — as most WPLib Box problems unfortunately often are — please provide your
described above in vagrant up is failing.
(We will be so happy once we have eliminated the need for Vagrant. Soon!)