Deploying to the App Engine Standard Environment

This document describes how to deploy an App Engine application to the App Engine standard environment from within IntelliJ IDEA.

Before you begin

  • Follow the Quickstart to install and set up IntelliJ IDEA if you have not already. Then return to this document.

  • To deploy to the App Engine standard environment from IntelliJ Ultimate Edition, you must install the Google Cloud SDK Java Extensions:

    gcloud components install app-engine-java

  • Follow the Create an App guide to create an App Engine app for the standard environment. Be sure to add App Engine standard framework support.

    If you don't have an application but still want to try these deployment procedures, download the sample app:

    1. Clone the Hello World sample app to your local machine:

         git clone
    2. In IntelliJ, select File > Open to open the file selector.

    3. Navigate to /java-docs-samples/appengine/.

    4. Select the /helloworld/ directory.

    5. Click OK.

Creating the deployment configuration

  1. Choose Tools > Google Cloud Tools > Deploy to App Engine....

    Screenshot showing the fields on the Create Deployment
Configuration dialog.

  2. Confirm the server configuration:

    1. Click the ellipsis (...) next to the Server field.

    2. In the dialog, verify that the Name field displays Google App Engine.

    3. Verify that the Cloud SDK directory field displays the correct path to where you installed the Cloud SDK.

    4. Click OK.

  3. Select the Deployment source.

    Cloud Tools for IntelliJ supports deploying from a Maven artifact or a native IntelliJ artifact.

  4. Select a project in the Project field.

    The first time you configure the deployment, you will be prompted to sign in to the account associated with the GCP Console project that you want to deploy.

    Screenshot showing the project selection field now visible that
     previously was hidden until the Server field was populated.

  5. Fill in other fields as needed to configure the deployment.

  6. Click Run to build and deploy your app.

  7. In the Application Servers window, click the name of your project to monitor its deployment progress. If the window is not displaying, click View > Tool Windows > Application Servers.

    After deployment completes, you can view your app's URL in the console output.

Update the App Engine standard configurations

After creating the initial deployment configuration, you can make changes to those configurations as needed by your application.

  1. Select File > Project Structure.

    The Project Structure dialog displays.

  2. Under Project Settings, select Facets.

  3. Select the Google App Engine standard facet.

    A dialog that displays a left navigation with
Project Settings (Project, Module, Libraries, Facets, Artifacts). It also
displays Platform Settings (SDKs, Global Libraries). The Facets option is
selected, and the middle column displays the facets associated with the
project. The right column displays the available libraries for the project,
and indicates which libraries have been selected.

  4. Select the libraries you want to add to your project.

  5. Click OK.

Deleting the server

If you ever want to delete the server you configured for your project, you can do so as follows:

  1. Choose File > Settings > Build, Execution, Deployment > Clouds.

    On Mac OS X, this is IntelliJ IDEA > Preferences > Build, Execution, Deployment > Clouds.

  2. Select your server (Google App Engine) and click the minus sign (-) at the top of the window to remove it.

  3. Click OK.

What's next

Send feedback about...

Cloud Tools for IntelliJ