Skip to content
Snippets Groups Projects
README.md 1.72 KiB
Newer Older
benedikt.kroening's avatar
benedikt.kroening committed
# Open-Xchange App Suite Installer script collection

This collection contains several scripts for letting you install a fully fledged Open-Xchange environment.
By default this will install a singlenode environment consititing of:
    - Database (mysql or mariadb)
    - Open-Xchange middleware
    - Apache2 Frontend

## Configuration

Basic Configuration is located inside the file `config/config`.
TBD

## Versions

Versions can be configured at `setup/versions`
Check that file for more information.

## Good to know

This script collection has its roots in the old ox-quickinstall (or installer). Much of the install logic for the different distros was simply taken from there and still can be found at `lib/common.bash`

## How to use

Simple cli examples of how to use this

It is always a good idea to read documentation or help texts!

`./ox-installer --help`

## Install singlenode with everything you need

Right now only frontend (apache), middleware and a database are installed.
It uses dovecot.qa.open-xchange.com as mail backend.

`$ ./ox-installer --singlenode`

You can supply each component individually. Read the help text for more information.

## Docker

This installer supports creation of Open-Xchange docker images. These images will use supervisord as process monitor.
Right now it creates a simple groupware image (apache2, ox frontend, ox middleware). Seperate mail and database services are required.
Take a look at the docker-compose.yml at the root level of this repo.

### Build images

`$ ./ox-installer --build-docker`

### Start it

If you have docker-compose available you can use it to start the provided compose-environment

`$ docker-compose up`

### Stop it

`$ docker-compose down -v`

### Clean it up

`$ rm -fr .runtime/`