Skip to content

Installation

Jump to bottom
Peter Adams edited this page Jan 18, 2022 · 19 revisions

Before you begin...

  1. Read the technical requirements to make sure that OWA can be installed on your system.

  2. Read the required permissions page to understand what file system permissions are required by OWA during install as well as how you can harden your instance after installation is complete.

Install Steps

1. Setup Your Database & Connection Info

OWA requires connection info for a database where it can install its schema and store data. It's best create a new database for OWA and to have this info ready before proceeding further.

Connection Param Description
Host This is the hostname where your database can be accessed. This could be a remote host such as db.yourdomain.com or, if OWA is running on the same host as your database instance you can use localhost.
Database Name This is the name of the database that OWA should read and write to. This database needs to be created if it does not exist prior to starting the install.
User This is the user name that OWA will use to connect to your database server. This database user name must have permission to read and write to the database that you want OWA to use.
Password This is the password of the database user.

OWA will write this information to a newly created owa-config.php configuration file - where it can be changed later if you need to modify the database that OWA read and writes from.

The OWA installer will create all the tables that it needs using the owa_ table prefix.

2. Get the latest OWA release

  • Install OWA by Downloading the latest release package.
  • Decompress the release package file
  • Move the decompressed owa folder somewhere within the document root of your web server. The owa folder must be accessible by web browsers.

(Alternatively you can also install OWA from Github.)

3. Run the install Wizard

  • Start the installation wizard by pointing your web browser at: http://yourdomain/path/to/owa/install.php

4. Integration Plugins

If you are using OWA in connection with a CMS system such as WordPress or Mediawiki, install one of the official Integration Plugins.

Re-install

Use the following steps to perform a clean re-install of OWA:

  • Drop all owa_ tables from your database
  • Remove any cache sub directories (usually: /path/to/owa/owa-data/caches/1)
  • Re-run the install wizard which will now be accessible

Updating

See the Updating page for details on how to update your existing OWA instance.

Clone this wiki locally