Meza/Install on Virtual Box

Expert steps

 * 1) Setup a machine in Virtual Box with a NAT as network adapter 1 and a host-only as adapter 2.
 * 2) Install CentOS minimum install on a virtual machine. This won't have networking enabled or SSH installed.
 * 3) Boot your VM, and type these in (without SSH you can't copy-paste)
 * 4) Now SSH into your machine and run   then.

This will setup a demo wiki with the user  with password. Update this password or remove this user for production environments. To add wikis see Meza/Adding wikis.

Detailed steps
Below are detailed steps to get meza running on your machine.

Downloads and Installs

 * 1) Download and install VirtualBox
 * 2) Install Git
 * 3) On Windows only, you also need to use this for the Git Bash terminal (once installed right click on any window and select "git bash here")
 * 4) On Windows only, install PuTTY (You probably want the "Windows MSI installer")
 * 5) Download CentOS 7 minimal install into your home directory (e.g.  )
 * 6) Clone the meza repository in your terminal:

Create a new VM

 * 1) Create a new Virtual Machine (VM) in VirtualBox:
 * 2) Change to meza's scripts directory:
 * 3) Run the Create VM script:   and follow the prompts. You need at least 10GB of disk space for a basic install.
 * 4) Install CentOS onto your new VM: Start the VM and follow the prompts.
 * 5) If you intend for this VM to have a large amount of wiki data (requiring >50 GB for the database, uploaded files, and any backup files from another server), you'll need to configure partioning at the "Installation Summary" screen, via "Installation Destination". Under "Other Storage Options", select "I will configure partitioning." Upon clicking "Done" you will be prompted to configure partition allocation. You can "Click here to create them automatically" and then make adjustments. For an example with 100 GiB total, if you allocate 1 GiB to   you can then allocate 100 GiB to  . It will automatically adjust to allocate as much as possible from the remaining amount while leaving enough for   and.

Configure the VM
Once installed, you'll need to get networking started. Unfortunately in these first few steps you can't copy/paste, so you'll have to type these manually.

These steps do the following:
 * 1) Start networking
 * 2) Get the meza setup script
 * 3) Setup the   command
 * 4) Adds SSH, starts host-only network adapter

Confirm SSH works

 * 1) Assuming your VM's IP address is 192.168.56.56
 * 2) For Mac/Linux/Unix, open your terminal and run   or
 * 3) For Windows, open PuTTY and type 192.168.56.56 into the "Host Name (or IP address)" field and hit "Open" then login with your credentials

Shutdown, snapshot

 * 1) Shutdown your VM:
 * 2) Take a snapshot and call it something like "baseline configuration". Click the "snapshots" icon in the top-right of VirtualBox and then click the camera icon. You'll be able to jump back to this point at any time.

Install wiki server

 * 1) Start your VM
 * 2) SSH into the VM
 * 3) Run  to setup the   command and get some things ready
 * 4) Run   to install your wiki server.

This will setup a demo wiki with the user  with password. Update this password or remove this user for production environments. To add wikis see Meza/Adding wikis.

Red Hat
Want to setup a Red Hat VM instead of CentOS? See Meza/Setup a RedHat VM.

Creating a clone of a VM
It's possible to create a clone of a virtual machine. While this is not specific to Meza, cloning VMs is sometimes useful when working with wikis and Meza. See Meza/Cloning VirtualBox VMs for more info.