Stay organized with collections Save and categorize content based on your preferences.
Caution: As of January 31, 2024, Java 8 support for App Engine has ended, and will be deprecated on January 31, 2026. As a result, Cloud Code disables App Engine by default. To enable App Engine in your IDE, navigate to Settings > Google Cloud Code > App Engine. Due to the upcoming deprecation of App Engine, we don't recommend creating new App Engine projects. For more information about App Engine deprecations, see Feature deprecations. For more information about the runtime support schedule for App Engine, see Runtime support schedule.Prior to deploying your application to App Engine, you can run and debug your App Engine standard application locally. This document describes how to configure the IDE for local run and debug from within IntelliJ IDEA.
Note: The following IDEs support this feature:Ensure your application is an App Engine standard project that contains an appengine-web.xml
file
To access the Cloud Client Libraries locally, complete the Adding Cloud Client Libraries to Your Maven Projects procedures.
If you're using IntelliJ IDEA Ultimate Edition, you can run an App Engine application locally by following these instructions:
Select File > Open to open the project you want to run.
Browse to the directory containing your project.
Select Tools > Cloud Code > App Engine Run on a local App Engine Standard dev server.
The project takes a moment to build.
Editing the run configuration Configure the serverYou can edit the run configuration for your local server:
Select Run > Edit Configurations.
From the Run/Debug Configurations dialog, update configuration settings as needed. Some common settings include:
If needed, add environment variables to your configuration.
Select the Startup/Connection tab.
Select Run.
Select the Pass environment variables checkbox.
Add the necessary variables.
Select Debug.
Select the Pass environment variables checkbox.
Add the necessary variables.
When finished, click OK.
To stop the Dev App Server, choose Run > Stop 'Google App Engine Standard Local Server'.
Debugging the applicationYou can use the run configuration you previously created to run your application in debug mode as follows:
Select Run > Debug.
In the dialog, click Google App Engine Standard Local Server.
After the project builds, you can set breakpoints to debug your app.
IntelliJ Community Edition does not provide built-in support for running local Java servlet-based applications. To debug your application locally using IntelliJ Community Edition, configure your project to use the Maven or Gradle plugin.
MavenConfiguring your project using the Maven plugin
Add the App Engine Maven plugin to your project's pom.xml
file.
Create Run/Debug configuration for Maven.
Select Run > Edit Configurations.
Click + Add New Configuration.
Select Maven.
In the Command line field, enter appengine:run
.
Click OK.
Create a remote debug configuration.
Select Run > Edit Configurations.
Click + Add New Configuration.
Select Remote.
Ensure that the port number is the same as the port you configured in your Maven App Engine plugin configuration. Port 5005 is the default.
In the Before launch section, click + Add.
Select Run Another Configuration.
Select the run configuration for your Maven project.
Click OK.
To debug your application locally:
Select Run > Debug.
Select your remote debug configuration.
You can now debug your application locally.
Configuring your project using the Gradle plugin
Create Run/Debug configuration for Gradle.
Select Run > Edit Configurations.
Click + Add New Configuration.
Select Gradle.
In the Gradle project field, select the module where you configured the appengine-gradle-plugin
plugin.
In the Tasks field, enter appengineRun
.
Click OK.
Create a remote debug configuration.
Select Run > Edit Configurations.
Click + Add New Configuration.
Select Remote.
Ensure that the port number is the same as the port you configured in your Gradle App Engine plugin configuration. Port 5005 is the default.
In the Before launch section, click + Add.
Select Run Another Configuration.
Select the run configuration for your Gradle project.
Click OK.
To debug your application locally:
Select Run > Debug.
Select your remote debug configuration.
You can now debug your application locally.
If the Attach Debugger link appears in the console log, click the link.
Note: If the port you've chosen is blocked, configure a different port number (for example, 5009) in your Gradle App Engine plugin configuration and update the port number in the remote configuration to the same port number.To submit feedback or report an issue in your IntelliJ IDE, go to
Tools>
Cloud Code>
Help / About>
Submit feedback or report an issueto report an issue on
GitHub.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["Cloud Code supports running and debugging App Engine standard applications locally within IntelliJ IDEA, but Java 8 is the only supported runtime."],["App Engine support in Cloud Code is being deprecated, with Java 8 support having ended in January 2024 and full deprecation scheduled for January 2026, so it's not recommended to create new App Engine projects."],["IntelliJ IDEA Ultimate Edition allows for direct local running and debugging through built-in configurations, while Community Edition requires using Maven or Gradle plugins."],["When debugging, you can set breakpoints and configure environment variables in the run configuration, and stopping the server is done through the Run menu."],["Maven or Gradle projects require the respective plugins to be added and run/debug configurations to be made for the plugin and remote debugging, for local debugging in the Community Edition of IntelliJ."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4