Skip to content
This repository has been archived by the owner on Mar 27, 2022. It is now read-only.

Virtual Appliance

Jump to bottom
Tim Morgan edited this page Sep 29, 2018 · 26 revisions

NOTE: We assume you'll be installing our OVF in your existing virtualization infrastructure. If you don't have any, then this may not be what you're looking for...

Instructions below give an example of how to install the OVF in VirtualBox, but your infrastructure may be completely different. YMMV.

  1. Download and install VirtualBox or some other hypervisor technology that supports Open Virtualization Format (OVF), such as VMWare Workstation or ESX. You can find a list of software that supports OVF here.

    These instructions show how to import the OVF using VirtualBox. You should consult your software's documentation for instructions specific to you.

  2. Download the latest zip file here: downloads.church.io. Unzip the file somewhere on your hard drive where the contents can be stored permanently.

  3. Import the appliance by selecting the onebody.ovf file you just got from the zip file.

  4. Once the machine is imported, right-click and choose settings.

  5. Click the Network tab and then choose advanced.

  6. Click Port Forwarding

  7. Forward port 8080 from your local machine to the VM, as shown here:

  8. Save the settings and start the VM.

  9. Once the VM is booted up, you can visit the website at http://localhost:8080.

Ports

You should forward the following ports from the outside world if you intend to use this in production:

port protocol
80 http (Apache)
25 smtp (Postfix)

DNS

In production, you'll likely want a domain name people can remember :-) The following DNS entries should be added:

type hostname destination
A record yourdomain.com 1.2.3.4
MX record yourdomain.com yourdomain.com

SSH (Warning)

The default user is:

username: onebody
password: onebody

You should definitely log in and change this password if you ever intend to expose SSH (port 22) to the outside world.

WARNING: If you intend to expose the SSH port to the Internet, you MUST regenerate the server keys first! If you don't, you will be hacked.

Deploying in Production

You can help write this section! How are you using this appliance?

Troubleshooting

If you get a black screen on boot in VirtualBox, here is how to fix it:

Clone this wiki locally