Note

These instructions assume a clean installation of the local operating system.

Google App Engine 1.9.18

Important

These instructions assume a paid Google App Engine account has already been setup.

Production

Important

The server must be configured locally before being uploaded to Google App Engine, so these instructions apply to the local operating system, unless stated otherwise.

Ubuntu 14.04 LTS (Trusty)

Install the cURL tool and the Nano editor:

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get install curl nano

Install the PHP 5.6 CGI and the GD and JSON PHP extensions:

sudo apt-get install php5-cgi php5-gd php5-json

Install Python 2.7:

sudo apt-get install python

Fedora 21, Centos 7.0, and Red Hat Enterprise Linux 7.0

Install the cURL tool and the Nano editor:

sudo yum update
sudo yum install curl nano

Install the PHP CLI and GD PHP extension:

sudo yum install php-cli php-gd

The JSON PHP extension is installed along with the PHP preprocessor.

Install Python 2.7:

sudo yum install python

OS X 10.10 Yosemite

Install Xcode and/or the Command Line Tools for Xcode. A satisfactory version of the PHP 5.5 CLI, with the GD and JSON PHP extensions, is installed on the system by default. Python 2.7 is also installed on the system by default.

Development

Important

Begin by following the above instructions for production.

Ubuntu 14.04 LTS (Trusty)

Install the cURL and Xdebug PHP extensions:

sudo apt-get install php5-curl php5-xdebug

Install the MySQL 5.5 database server:

sudo apt-get install mysql-server

Install the Git 1.9 distributed version and Subversion 1.8 version control system:

sudo apt-get install git subversion

Fedora 21, Centos 7.0, and Red Hat Enterprise Linux 7.0

Install the Xdebug PHP extension:

sudo yum install php-pecl-xdebug

The cURL PHP extension was previously installed along with the PHP preprocessor.

Install, enable, and start the MariaDB database server:

sudo yum install mariadb-server
sudo systemctl enable mariadb.service
sudo systemctl start mariadb.service

MariaDB is a fork of MySQL.

Install the Git distributed version control system and Subversion version control system:

sudo yum install git subversion

OS X 10.10 (Yosemite)

Install the Homebrew package manager, enable the Homebrew PHP repository, and install the PHP 5.6 CGI.

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew tap homebrew/php
brew update
brew upgrade
brew install php56
echo /usr/local/opt/php56/bin | sudo tee -a /etc/paths.d/20-PHP56

The GD and JSON PHP extensions are installed along with the PHP preprocessor.

Install the Xdebug PHP extension:

brew install php56-xdebug

The cURL PHP extension was previously installed along with the PHP preprocessor.

Install, enable, and start the MySQL database server:

brew install mysql
ln -sf /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist

The Git distributed version control system and Subversion version control system are installed on the system as part of the Command Line Tools for Xcode.

Production and Development

Download and install the Google App Engine SDK.

Create a new project in the Google Developers Console. The project name will also be the application ID of the Google App Engine application.

Within the new project, create a new Google Cloud Storage bucket, and a new Google Cloud SQL instance.

Important

Ensure that the “preferred location” of the Cloud SQL instance is set to “specify App Engine application” and the project name is specified, and ensure that the project name is specified in the list of “authorized App Engine applications”.