4.9 KiB
OpenPhoto / Installation for OSX using Macports
OpenPhoto, a photo service for the masses
OS: Mac OSX
This guide instructs you on how to install OpenPhoto on a Macintosh OSX computer with Macports.
If you don't have Macports installed you can get it here. The easiest option is to use .pkg installer.
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.
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.
sudo port install apache2
sudo port install php5 +apache2
cd /opt/local/apache2/modules
sudo /opt/local/apache2/bin/apxs -a -e -n "php5" libphp5.so
sudo port install php5-exif
sudo port install php5-curl
sudo port install php5-imagick
sudo port install php5-oauth
sudo port install php5-mcrypt
sudo port install php5-apc
sudo port load apache2
Installing OpenPhoto
Download and install the source code. We recommend ~/Sites/yourdomain.com but you can use any directory you'd like.
Using git clone
# OSX should have git already installed. If not:
sudo port install git-core
git clone git://github.com/photo/frontend.git ~/Sites/yourdomain.com
Using tar
cd ~/Sites
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 can make the config writable by the user Apache runs as, most likely _www.
cd ~/Sites/yourdomain.com
mkdir src/userdata
chown _www src/userdata
Setting up Apache and PHP
Apache
You'll need to make sure that you have named virtual hosts enabled in your Apache confs.
sudo nano /opt/local/apache2/conf/httpd.conf
Enable virtual hosts:
# Virtual hosts
Include conf/extra/httpd-vhosts.conf
Ensure the PHP module is loaded (various places in httpd.conf):
LoadModule php5_module modules/libphp5.so
DirectoryIndex index.html index.php
Include conf/extra/mod_php.conf
Copy the contents of ~/Sites/yourdomain.com/src/configs/openphoto-vhost.conf onto your clipboard. Then open your httpd-vhosts.conf file.
sudo nano /opt/local/apache2/conf/extra/httpd-vhosts.conf
You can put the NameVirtualHost directive at the top of the file.
NameVirtualHost *
Paste the contents of your clipboard into the bottom of the file and replace instances of /path/to/openphoto/html/directory with /Users/yourusername/Sites/yourdomain.com/src/html or wherever you placed the code. In the virtualhost conf make sure to specify the full path to your Sites directory.
By default, any access to ini files is denied with a "Not Found" 404 HTTP code. To enable a 404, 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.
sudo nano /opt/local/etc/php5/php.ini
If the file is empty, copy the development template file
sudo cp /opt/local/etc/php5/php.ini-development /opt/local/etc/php5/php.ini
Search for the following values and make sure they're correct.
post_max_size = 16M
file_uploads = On
upload_max_filesize = 16M
Now you're ready to restart apache and visit the site in your browser.
sudo /opt/local/apache2/bin/apachectl restart
Fake domain
If you happen to not have yourdomain.com registered, you can fake it by editing your /etc/hosts file and adding the following line
127.0.0.1 yourdomain.com
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.
Performing setup again
If for any reason you want to go through the setup again, delete the generated config file and refresh your browser.
rm ~/Sites/yourdomain.com/src/userdata/configs/settings.ini
ENJOY!