Skip to content
This repository has been archived by the owner on Jun 12, 2019. It is now read-only.


Folders and files

Last commit message
Last commit date

Latest commit



70 Commits

Repository files navigation

twlight_vagrant (Deprecated)

The Library Card Platform for The Wikipedia Library now uses Docker and doesn't require a separate project for its development environment.


Deploys and configures the Library Card Platform for The Wikipedia Library in a vagrant environment.


Those developing Library Card Platform for The Wikipedia Library.



Notes for Linux users:

For a "just works" experience, I recommend fetching Vagrant and VirtualBox packages from the vendor websites rather than using your distribution's software repositories. Those likely include fairly old versions of the required packages, and you will find yourself having to carefully managing your Vagrant, VirtualBox, and base box updates to avoid breakage, if it's not broken out of the gate.

Notes for Windows users:

Some third-party endpoint security software, such as Dell Data Protection Encryption and several McAfee products, interfere with VirtualBox. You may need to temporarily disable these products or make different endpoint protection choices.

You'll need to add the following directory to your PATH environment variable after installing VirtualBox:

C:\Program Files\Oracle\VirtualBox

See this example from Microsoft for adding a path to the PATH environment variable.

Vagrant's (early but generally working) support for Ubuntu via the Windows Subsystem for Linux is the recommended way to run this enviroment. You should be on Windows 10 Version 1709 or later and perform a store-based Ubuntu installation. See the Vagrant and Windows Subsystem for Linux instructions. You'll install VirtualBox on the Windows side, and then install exactly the same build of Vagrant in both Windows and Ubuntu. The Linux notes apply to the Ubuntu environment. Just download a fixed version of Vagrant (that matches the version you install in Windows) and install using dpkg as described in the instructions. Install any plugins in Ubuntu.

On Vagrant 2.0.2 and earlier, issue #9298 means you'll need to create a symlink in the location of the deprecated lxrun installation that points to the new store-based installation. As pointed out in the reported issue, running the following powershell commands on the windows side will pull the information from the registry and create the appropriate symlink.

$WSLDEFID=(Get-ItemProperty "$WSLREGKEY").DefaultDistribution
New-Item -ItemType Junction -Path "$env:LOCALAPPDATA\lxss" -Value "$WSLFSPATH\rootfs"


Clone this repository, which is where you will be running Vagrant.

You might need to configure some of the settings for the puppet module; to do so, create the following yaml file:


and configure any parameters you'd like to override, such as the git repository or revision. See the parameters manifest in the puppet module.

If you have a tarball that you'd like to load on provision, place it


Alternatively, scripts are included to create a superuser and generate example data. Before doing anything else, login to the platform as normal, then run

sudo -u www /var/www/html/TWLight/bin/

The account you used to login will be made a superuser, giving you access to the Admin interface. The values in that file can be modified to generate more or less users, partners, and applications, but the file should only be run once.

You'll need to use an SSH SOCKS proxy to access the web interface. To do so specify a dynamic tunnel when you vagrant ssh, e.g.

vagrant up
vagrant ssh -- -D 2080

Then point a browser (configured to use your proxy on 2080) to: http://twlight.vagrant.localdomain

You can now work on the running app inside Vagrant and view the changes in your browser. As you are making local changes, make sure to take advantage of the included test suite. To do so, run the following command within the vagrant machine:

sudo su www /var/www/html/TWLight/bin/