Notice: Over the next few months, we're reorganizing the App Engine documentation site to make it easier to find content and better align with the rest of Google Cloud products. The same content will be available, but the navigation will now match the rest of the Cloud products. If you have feedback or questions as you navigate the site, click Send Feedback.

Setting up your development environment

Stay organized with collections Save and categorize content based on your preferences.

Go

To set up your environment for developing on Go:

  1. Install the latest release of Go.

    See Go Runtime for a list of the supported versions, or see Custom Runtimes for information about using other Go versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

  3. Install the gcloud component that includes the App Engine extension for Go. If you used the apt or yum package managers to install the gcloud CLI, use those same package managers to install the gcloud component.

    Otherwise, use the following command:

    gcloud components install app-engine-go

Installing optional tools

  • For access to code, samples, libraries, and tools in GitHub, install Git:

    Install Git

Java

To set up your environment for developing on Java:

  1. Install the latest release of Java.

    See Java 8 / Jetty 9 Runtime or Java 8 Runtime for details, or see Custom Runtimes for information about using other Java versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

  3. Install the gcloud component that includes the App Engine extension for Java.

    If you used the apt or yum package managers to install the gcloud CLI, use those same package managers to install the gcloud component.

    Otherwise, use the following command:

    gcloud components install app-engine-java

Installing optional tools

These editors (sometimes with the help of plugins) give you everything from syntax highlighting, intelli-sense, and code completion to fully integrated debugging capabilities.

Node.js

To set up your environment for developing on Node.js:

  1. Install the latest release of Node.js. See Node.js Runtime for a list of the supported versions, or see Custom Runtimes for information about using other Node.js versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

Installing optional tools

  • For access to code, samples, libraries, and tools in GitHub, install Git:

    Install Git

  • The npm package manager is usually installed alongside Node.js, but you also have the option to install the Yarn package manager as an alternative.

  • To easily manage your Node.js and npm installations, install Node Version Manager (nvm): Install nvm

    If you use Windows, see nvm-windows.

  • Install your preferred tooling or framework, for example you can use the Express.js framework.

PHP

To set up your environment for developing on PHP:

  1. Install the latest release of PHP.

    See PHP Runtime for a list of the supported versions, or see Custom Runtimes for information about using other PHP versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

Installing optional tools

Python

To set up your environment for developing on Python:

  1. Install the latest release of Python. See Python Runtime for a list of the supported versions, or see Custom Runtimes for information about using other Python versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release. By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

Installing optional tools

Ruby

To set up your environment for developing on Ruby:

  1. Install the latest release of Ruby.

    See Ruby Runtime for a list of the supported versions, or see Custom Runtimes for information about using other Ruby versions.

  2. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

Installing optional tools

  • For access to code, samples, libraries, and tools in GitHub, install Git:

    Install Git

  • Install your preferred tooling or framework, for example the Sinatra or Ruby on Rails frameworks.
  • To easily manage your Ruby dependencies, install Bundler:

    gem install bundler
    

.NET

To set up your environment for developing on .NET:

  1. Install the latest release of .Net. See .Net Runtime for a list of the supported versions.

  2. Install the .NET Core SDK, LTS version.

  3. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

Installing optional tools

Custom

To set up your environment for developing on a Custom Runtime:

  1. Install and initialize the gcloud CLI for deploying and managing your apps. If you already have the gcloud CLI installed and initialized, run the gcloud components update command to update to the latest release.

    By downloading, you agree to be bound by the Terms that govern use of the gcloud CLI for App Engine.

  2. To locally test and run your App Engine custom runtime apps, install Docker:

    Install Docker

  3. Don't forget to set up your environment. For example, install a version of your custom runtime and your preferred tooling.

Installing optional tools

  • For access to code, samples, libraries, and tools in GitHub, install Git:

    Install Git