OpenGoo Appliance

Overview

OpenGoo is an Open Source Web Office (see http://www.opengoo.org/about.html for more info)

I have started working on setting this up as an appliance (based on Turnkey Linux LAMP)

I currently have this working quite well. I haven't spent a lot of time testing yet but it all seems to be ok.

These instructions assume that you have a working install of Turnkey LAMP (I used a virtual machine in VirtualBox but that shouldn't make any difference).

Setup using Webmin (can be done remotely via web browser)

To use these instructions you will need to log into your Turnkey Server from a web browser. On a default Turnkey LAMP setup you'll need to browse to https://your.appliance.ip:12321/ and log in. If you'd rather use the console, see below.

1) To be able to upload files to your server using Webmin you will need to install the zip/unzip packages.

• Select Software Packages (Sytem > Software Packages)
• Update packages - click <Upgrade Now> (bottom of the page)
• Install new package - Select Packages from APT - write zip unzip then click <Install>

2) OpenGoo requires a php extension that isn't included with Turnkey LAMP by default so you need to install php5-gd as well.

• Install new package - Select Packages from APT - write php5-gd then click <Install>

There are a number of dependencies that will need to be installed, but Turnkey Linux will take care of sorting all that out.

3) Download the OpenGoo zip package (if you haven't already). http://www.opengoo.org/downloads.html

4) Upload OpenGoo

• Select File Manager (Tools > File Manager)
• Click <Upload> (you may need to allow pop-ups)
• <Browse> to OpenGoo.zip
• Upload to /var/www
• Select Yes (or Yes and delete) - Uncompress ZIP or TAR file
• Click <Upload>

5) Change ownership (permissions) of /var/www/opengoo directory. To make OpenGoo 'automatically' upgradeable you will need to change ownership of the whole folder.

• Still in File Manager (Tools > File Manager)
• In the left pane, click var then www now in the right pane click on opengoo
• Click <Info>
• Change Ownership to www-data and set it to apply to This directory and all subdirectories (drop down at the bottom). Click <Save>

If you would rather not allow full web server write access and are happy to install OpenGoo updates manually you can just set the permissions of the indivdual folders. The folders are all located in /var/www/opengoo. They are

• /config
• /public/files
• /cache
• /upload
• /tmp

Now Install OpenGoo (see below)

Setup using Console (logged into local Turnkey server)

1) To keep the instructions inline with the above Webmin method, install the zip/unzip packages.

apt-get update 
apt-get install zip unzip 

2) Install php5-gd

apt-get install php-gd

There are a number of dependencies that will need to be installed, but Turnkey Linux will take care of sorting all that out.

3) Download the OpenGoo zip package (if you haven't already). http://www.opengoo.org/downloads.html

4) Upload OpenGoo.zip to /var/www using your preferred method eg ftp, rsync etc. Then unzip

unzip /var/www/opengoo.zip

you can then delete the .zip package if you'd like.

5) Change ownership (permissions) of /var/www/opengoo directory. To make OpenGoo 'automatically' upgradeable you will need to change ownership of the whole folder.

chown www-data:www-data /var/www/opengoo

If you would rather not allow full web server write access and are happy to install OpenGoo updates manually you can just set the permissions of the indivdual folders.

chown www-data:www-data /var/www/opengoo/config
chown www-data:www-data /var/www/opengoo/public/files
chown www-data:www-data /var/www/opengoo/cache
chown www-data:www-data /var/www/opengoo/upload
chown www-data:www-data /var/www/opengoo/tmp

Now Install OpenGoo (see below)

Install OpenGoo

Now comes the easy part!

Using your web browser, browse to OpenGoo: http://your.appliance.ip/opengoo/

Just follow the instructions at http://wiki.opengoo.org/doku.php/installer, its pretty straight forward.

For more info please read the OpenGoo Manual (http://wiki.opengoo.org/doku.php/Home) - User's manual first, followed by the Administrator's manual (scroll down).

Please msg me if there is something I've missed or something that needs a bit more clarification (especially if its before I get a chance to get back and tidy up)

Good luck!