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

Configuration

Steven Jones edited this page Jun 15, 2016 · 11 revisions

You can configure how Parrot's Vagrantfile sets things up and adjust settings that built the generated virtual machine.

To configure Parrot, place a file called: config.yml into the root of the parrot directory. You can then add options and values into the file, for example, the defaults are:

sites: "sites"
databases: "databases"
memory: 2048
with_gui: false
ip: "192.168.50.4"
webroot_subdir: ""
box_name: "Parrot"
varnish_enabled: false
cpus: 1
forward_solr: true
forward_mysql: true
forward_varnish: true
forward_apache: true
forward_https: true
forward_dovecot: true

The syntax is yaml, in case you hadn't guessed.

The options that you can configure are:

  • sites - This is the location relative to the Vagrantfile location that will be searched for directories to add a vhosts.
  • databases - This is the location relative to the Vagrantfile location that will be searched for .sql files that will be automatically imported.
  • memory - The amount of memory to provision the virtual machine with, in MB.
  • with_gui - Show the virtual machine provider's GUI when the virtual machine is booted.
  • ip - The IP address of the provisioned virtual machine. Note that this will need to be unique among running virtual machines on your host machine.
  • webroot_subdir - A subdirectory within each sites directory to append to create the Apache vhost doc root. If you use this, you want a leading slash, but not a trailing one.
  • box_name - The identifier of the VM. Useful if you want multiple instances of Parrot to run simultaneously.
  • varnish_enabled - Normally Varnish is running, but traffic does not go through it, but if you want to use Varnish, then set this option to true.
  • cpus - The number of virtual CPUs to give to the Parrot virtual machine.
  • forward_solr - Determine if the Solr port should be forwarded from host to guest.
  • forward_mysql - Determine if the MySQL port should be forwarded from host to guest.
  • forward_varnish - Determine if the Varnish port should be forwarded from host to guest.
  • forward_apache - Determine if the Apache port should be forwarded from host to guest.
  • forward_https - Determine if the HTTPS port should be forwarded from host to guest.
  • forward_dovecot - Determine if the Dovecot port should be forwarded from host to guest.

Note: to configure forwarded ports, edit the 'Vagrantfile' file at the root of your parrot installation, and take note of the existing forwarded ports. This should be done very carefully! Guest ports with numbers greater than 1024 can be forwarded to the same number on the host, but those lower than 1024 need forwarding to a new number, greater than 1024. Port numbers should be kept unique.

Clone this wiki locally