OpenPhoto / Installation for Ubuntu + Apache

OpenPhoto, a photo service for the masses

OS: Linux Ubuntu Server 10.04+

This guide instructs you on how to install OpenPhoto on an Ubuntu Server.


Prerequisites

Database and File System Options

MySql

You'll need to provide credentials for a MySql database. If the database doesn't already exist it will be created. If the user doesn't have CREATE DATABASE permissions then make sure it's already created.

AWS

If you're going to use AWS services then You'll need to be signed up for them.

  • http://aws.amazon.com/simpledb/
  • http://aws.amazon.com/s3/

Server Packages and Modules

Once you've confirmed that your cloud account is setup you can get started on your server. For that you'll need to have Apache, PHP and curl installed with a few modules.

apt-get update
apt-get upgrade
apt-get install apache2 php5 libapache2-mod-php5 php5-curl php5-gd php5-mcrypt php-apc build-essential libpcre3-dev php-pear
a2enmod rewrite

And if you are going to use MySQL install php5-mysql.

There are also a few optional but recommended packages and modules.

apt-get install php5-dev php5-imagick exiftran
pecl install oauth
a2enmod deflate
a2enmod expires
a2enmod headers

Installing OpenPhoto

Download and install the source code. We recommend /var/www/yourdomain.com but you can use any directory you'd like.

Using git clone

apt-get install git-core
git clone git://github.com/photo/frontend.git /var/www/yourdomain.com

Using tar

cd /var/www
wget https://github.com/photo/frontend/tarball/master -O openphoto.tar.gz
tar -zxvf openphoto.tar.gz
mv openphoto-frontend-* yourdomain.com

Assuming that this is a development machine you only need to make the config writable by the user Apache runs as. Most likely www-data.

mkdir /var/www/yourdomain.com/src/userdata
mkdir /var/www/yourdomain.com/src/html/photos
mkdir /var/www/yourdomain.com/src/html/assets/cache
chown www-data:www-data /var/www/yourdomain.com/src/userdata
chown www-data:www-data /var/www/yourdomain.com/src/html/photos
chown www-data:www-data /var/www/yourdomain.com/src/html/assets/cache

Setting up Apache and PHP

Apache

You'll need to copy the sample virtual host configuration file from the source to /etc/apache2/sites-available.

cp /var/www/yourdomain.com/src/configs/openphoto-vhost.conf /etc/apache2/sites-available/openphoto

You'll need to replace instances of /path/to/openphoto/html/directory with /var/www/yourdomain.com/src/html or wherever you placed the code. Depending on which modules you installed you may have to comment out some of the Expires* directives.

vi /etc/apache2/sites-available/openphoto

Now enable openphoto and disable Apache's default virtual host.

a2dissite default
a2ensite openphoto

By default, any access to ini files is denied with a "Not Found" 404 HTTP code. To enable a 403, or Forbidden return code, change the following lines in the virtual host file.

Uncomment:

# 403 Forbidden for ini files
#RewriteRule \.ini$ - [F,NC]

Comment:

# 404 Not Found for ini files
AliasMatch \.ini$   /404

PHP

You should also verify that your php.ini file has a few important values set correctly.

vi /etc/php5/apache2/php.ini

Search for the following values and make sure they're correct.

file_uploads = On
upload_max_filesize = 16M
post_max_size = 16M

Search for, and if needed add the following line to load the Oauth Extention.

extension=oauth.so

Now you're ready to restart apache and visit the site in your browser.

/etc/init.d/apache2 restart

Launching your OpenPhoto site

Now you're ready to launch your OpenPhoto site. Point your browser to your host and you'll be taken to a setup screen. You'll need your cloud account credentials to continue.

Once you complete the 3 steps your site will be up and running and you'll be redirected there. The setup screen won't show up anymore. If for any reason you want to go through the setup again you will need to delete the generated config file and refresh your browser.

rm /var/www/yourdomain.com/src/userdata/configs/yourdomain.com.ini

ENJOY!