Running and Debugging an App Engine Standard Project Locally Inside Eclipse

This page shows you how to run and debug your App Engine standard project in an emulator running on your local computer.

Running the project locally

  1. Select the project in the Project Explorer or Package Explorer.
  2. Open the context menu.
  3. Select Run As > App Engine.

  4. Log messages appear in the console as the server starts up.

  5. Eclipse opens its internal web browser to your application. You can also open an external browser and navigate to http://localhost:8080. Either way, you'll see a static HTML page with a link to the servlet.

    Available Servlets: The servlet

Debugging the project locally

To debug your project locally, complete the running the project locally steps, except select Debug As > App Engine instead of Run As > App Engine in the context menu.

The server stops at the breakpoints you set and shows the Eclipse debugger view.

Running App Engine Standard Apps on a Different Host or Port

To run your App Engine standard application on a different host or port:

  1. Right-click your project.

  2. Select Run As > Run on Server.

    A dialog box to select which server to use when running your app. The
dialog provides a radio button to select an existing server or to manually
enter a new server. It provides an area to select a server type. It also
provides fields to enter the server hostname and server name. It provides a
drop-down menu to select the server runtime environment and a field to
enter the server port.

  3. In the dialog, select Manually define a new server.

  4. Select App Engine Standard as the server type.

  5. Enter the hostname in the Server's host name field.

  6. Enter the port in the Server port field.

  7. Click Finish.

What's next