Higher Logic Vanilla (Vanilla) only has one supported localhost installation configuration: Vanilla Docker.
Vanilla Docker is a self-container, docker-compose setup providing:
- Local SSO & Embedding Stubs
brew install composer
composer self-update --1
Set up Vanilla Docker
Clone relevant repositories
Create a directory where you will clone all of your Vanilla repositories. Make sure this directory is shared in the Docker desktop settings.
- Your user directory is typically shared, making it an ideal location to put it.
In this guide, we will use the directory
In this scenario, the entire contents of the ~/vnla directory will be synchronized into the docker containers. Having an excessive amount of content here can slow things down, so it's recommended to only put content needed to run Vanilla into this directory.
Run the macOS setup script
Run the following setup script:
Symlink the docker config
ln -s ../../vanilla-docker/bootstrap.before.php
Installing Dependencies & Building
The next step is to install composer dependencies & node_modules, and then build the frontend.
The first time you run this, it may take a while. Subsequent runs should be faster.
- This build only works if you have installed your site. This should result in
conf/config.php file being generated.
- If you enable or disable an addon, you'll have to restart your build.
- If you create a new entry in an addon (e.g.,
src/scripts/entries ), you'll have to restart your build.
# Add This to you config.php
# $Configuration['HotReload']['Enabled'] = true;
# The run this
This is how you will start the Docker containers.
docker compose up --build -d
To shut down the containers in the future, run this:
docker compose down
Go to your site
- Finish filling out the form.
- Submit the form.
- See your new site.
Install Cloud addons
For vanilla employees only.
Run the following:
# Symlink cloud addons
# Install dependencies and rebuild frontend