Download the Google App Engine SDK

Installing on Linux

To install on Linux:

1. Unzip the App Engine SDK file you downloaded (google_appengine_1.9.36.zip), for example:

   unzip google_appengine_1.9.36.zip

   There is no App Engine installation script that you need to run after unzipping the files.

2. Add the google_appengine directory to your PATH:

   export PATH=$PATH:/path/to/google_appengine/

3. Make sure Python 2.7 is installed on your machine using the following command:

   /usr/bin/env python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now using the installation instructions for your Linux distribution.

Installing on Mac OS X

To install the SDK on Mac OS X:

1. In the Finder, click Go > Applications to open the Applications folder.

2. Double click the App Engine SDK file you downloaded (GoogleAppEngineLauncher-1.9.36.dmg) to open it, then drag the GoogleAppEngineLauncher icon over to the Applications folder.

3. Double-click GoogleAppEngineLauncher in the Application folder.

4. When prompted to Make command symlinks, click OK. The symlinks allow you to run important SDK command-line tools in any terminal window.

   Important: The GoogleAppEngineLauncher is a convenient UI-based tool for running and deploying App Engine apps, but it does not provide all the features you'll need. You will need to use the command-line equivalent, appcfg.py, for many of the features you'll want to use.

5. Notice that the installation process above unpacks the contents of the App Engine SDK at the location:

   /usr/local/google_appengine

6. The App Engine SDK requires Python 2.7, which is installed by default on Mac OS X 10.6 (Lion) or later. Verify your Mac's Python installation using the following command:

   /usr/bin/env python -V

   If the output looks like Python 2.7.<number> then you already have the correct Python version installed. Otherwise you can download and install Python 2.7 from the Python web site.

Installing on Windows

To install the SDK on Windows:

1. Double-click the SDK file you downloaded (GoogleAppEngine-1.9.36.msi) and follow the prompts to install the SDK.

2. You will need Python 2.7 to use the App Engine SDK, because the Development Server is a Python application. Download Python 2.7.X (don't use a higher version) from the Python web site.

See the Python documentation for more information on developing for Google App Engine with Python.

Installing on Linux

To install on Linux:

1. Unzip the App Engine SDK file you downloaded (appengine-java-sdk-1.9.36.zip) to a directory of your choice. For example:

   unzip appengine-java-sdk-1.9.36.zip

   There is no App Engine installation script that you need to run after unzipping the files.

2. Add the appengine-java-sdk-1.9.36 directory to your PATH:

   export PATH=$PATH:/path/to/appengine-java-sdk-1.9.36/bin/

3. The App Engine Java SDK requires Java 7 bytecode level. You can use either Java 7 or Java 8; be sure to set the javac compiler flags to generate 1.7 bytecode:

   -source 1.7 -target 1.7

   If you don't have Java or the correct Java version installed, download and install the Java SE Development Kit (JDK) for Linux.

Installing on Mac OS X

To install the SDK on Mac OS X:

1. Double click the App Engine SDK .zip file you downloaded (appengine-java-sdk-1.9.36.zip) to extract the SDK into a folder.

2. The App Engine Java SDK requires Java 7 bytecode level. You can use either Java 7 or Java 8; be sure to set the javac compiler flags to generate 1.7 bytecode:

   -source 1.7 -target 1.7

   If you don't have Java or the correct Java version installed, download and install the Java SE Development Kit (JDK) for Mac OS X.

3. Add the appengine-java-sdk-1.9.36 directory to your PATH:

   export PATH=$PATH:/path/to/appengine-java-sdk-1.9.36/bin/

Installing on Windows

To install the SDK on Windows:

1. Double click the App Engine SDK .zip file you downloaded (appengine-java-sdk-1.9.36.zip) to extract the SDK into a folder.

2. The App Engine Java SDK requires Java 7 bytecode level. You can use either Java 7 or Java 8; be sure to set the javac compiler flags to generate 1.7 bytecode:

   -source 1.7 -target 1.7

   If you don't have Java or the correct Java version installed, download and install the Java SE Development Kit (JDK) for Windows.

Installing on Linux

To install on Linux:

1. Unzip the App Engine PHP file you downloaded (google_appengine_1.9.36.zip). For example:

   unzip google_appengine_1.9.36.zip

   There is no App Engine installation script that you need to run after unzipping the files.

2. Add the google_appengine directory to your PATH:

   export PATH="$PATH:/path/to/google_appengine/"

3. Make sure Python 2.7 is installed on your machine using the following command:

   /usr/bin/env python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now using the installation instructions for your Linux distribution.

4. Build and install the PHP interpreter and App Engine PHP extension. Specify the path to php-cgi and gae_runtime_module.so when running the development server.

5. Install MySQL on your local machine. (You will need this to test your app locally.) On Debian-based Linux systems, you can use the following command:

   sudo apt-get install mysql-server-5.5

   You will be prompted to enter a password for the MySQL root user; make sure that you remember it.

Installing on Mac OS X

To install the SDK on Mac OS X:

1. In the Finder, click Go > Applications to open the Applications folder.

2. Double click the App Engine SDK file you downloaded (GoogleAppEngineLauncher-1.9.36.dmg) to open it, then drag the GoogleAppEngineLauncher icon over to the Applications folder.

3. Double-click GoogleAppEngineLauncher in the Application folder.

4. When prompted to Make command symlinks, click OK. The symlinks allow you to run important SDK command-line tools in any terminal window.

   Important: The GoogleAppEngineLauncher is a convenient UI-based tool for running and deploying App Engine apps, but it does not provide all the features you'll need. You will need to use the command-line equivalent, appcfg.py, for many of the features you'll want to use.

5. Notice that the installation process above unpacks the contents of the App Engine SDK at the location:

   /usr/local/google_appengine

6. The App Engine PHP SDK requires Python 2.7, which is installed by default on Mac OS X 10.6 (Lion) or later. Verify your Mac's Python installation using the following command:

   /usr/bin/env python -V

   If the output looks like Python 2.7.<number> then you already have the correct Python version installed. Otherwise you can download and install Python 2.7 from the Python web site.

7. Most PHP apps use a MySQL backend, which is not packaged with the App Engine SDK. To setup MySQL, visit the MySQL Downloads page; the "Community Server" edition will suffice for your local development.

Installing on Windows

To install the SDK on Windows:

1. Double-click the SDK file you downloaded (GoogleAppEngine-1.9.36.msi) and follow the prompts to install the SDK.

2. You will need Python 2.7 to use the App Engine PHP SDK, because the Development Server is a Python application. Download Python 2.7.X (don't use a higher version) from the Python web site.

   Note: The PHP SDK includes binaries for the PHP 5.4 runtime, including all enabled extensions, so there is no need to download PHP separately for the purposes of developing with App Engine -- you just need Python.

3. Most PHP apps use a MySQL backend, which is not packaged with the App Engine SDK. To set up MySQL, visit the MySQL Downloads page; the "Community Server" edition will suffice for your local development.

See the PHP documentation for more information on developing for Google App Engine with PHP.

Installing on Linux

To install on Linux 32-bit or 64-bit:

1. Unzip the App Engine SDK file you downloaded (go_appengine_sdk_linux_amd64-1.9.36.zip or go_appengine_sdk_linux_386-1.9.36.zip) to a directory of your choice. For example:

   unzip go_appengine_sdk_linux_amd64-1.9.36.zip

   There is no App Engine installation script that you need to run after unzipping the files.

2. Add the go_appengine directory to your PATH:

   export PATH=$PATH:/path/to/go_appengine/

3. Go requires Python 2.7.x; don't use a higher version. (The Go SDK uses tools from the App Engine Python SDK, so Python is required.) Make sure Python 2.7 is installed on your machine using the following command:

   /usr/bin/env python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now using the installation instructions for your Linux distribution.

Installing on Mac OS X

To install the SDK on Mac OS X 32-bit or 64-bit:

1. Double-click the App Engine SDK file you downloaded (go_appengine_sdk_darwin_amd64-1.9.36.zip or go_appengine_sdk_darwin_386-1.9.36.zip) to extract the SDK to a folder. It doesn't matter where you install the SDK. We suggest adding the folder to your PATH:

   export PATH=/path/to/go_appengine:$PATH

2. Go requires Python 2.7.x; don't use a higher version. (The Go SDK uses tools from the App Engine Python SDK, so Python is required.) Make sure Python 2.7 is installed on your machine using the following command:

   /usr/bin/env python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now from the Python web site.

Note: The Google App Engine Launcher does not work with Go apps.

Installing on Windows

To install the SDK on Windows 64-bit or 32-bit:

1. Double-click the App Engine SDK file you downloaded (go_appengine_sdk_windows_amd64-1.9.36.zip or go_appengine_sdk_windows_386-1.9.36.zip) to extract the SDK files to a location of your choice. It doesn't matter where you install the SDK; however you might want to add the location to your %PATH%.

2. Go requires Python 2.7.x; don't use a higher version. (The Go SDK uses tools from the App Engine Python SDK, so Python is required.) Make sure Python 2.7 is installed on your machine using the following command:

   python -V

   The output should look like this: Python 2.7.<number>. If Python 2.7 isn't installed, install it now from the Python web site.

3. Optionally, to simplify development and deployment, consider adding the App Engine Go SDK directory to your PATH environment variable by finding the "Environment Variables" in the Advanced System Settings dialog and setting it there.

See the Go documentation for more information on developing for Google App Engine with Go.