English
Skip to page content Skip to main navigation

e.g. "templates" or "datastore"

# Uploading Your Application

You create and manage applications in App Engine using the Administration Console. Once you have registered an application ID for your application, you upload it to App Engine using either the Eclipse plugin, or a command-line tool in the SDK.

April 2009: During this "early look" of Google App Engine for Java, the ability to upload Java applications to App Engine is reserved for a limited number of developer accounts. All users will be able to upload Java apps when we do a full release of Google App Engine for Java in the near future.

Note: There is no way to delete an application in App Engine. You can register up to 10 application IDs per Google account. If you do not want to use one of your allotted application IDs for the tutorial, you can just read this section, and refer to it later when you are ready to upload your first application.

## Registering the Application

You create and manage App Engine web applications from the App Engine Administration Console, at the following URL:

http://appengine.google.com/

Sign in to App Engine using your Google account. If you do not have a Google account, you can create a Google account with an email address and password.

To create a new application, click the "Create an Application" button. Follow the instructions to register an application ID, a name unique to this application. If you elect to use the free appspot.com domain name, the full URL for the application will be `http://application-id.appspot.com/`. You can also purchase a top-level domain name for your app, or use one that you have already registered.

Edit the `appengine-web.xml` file, then change the value of the `<application>` element to be your registered application ID.

## Uploading the Application

You can upload your application using Eclipse, or using a command at the command prompt.

### Uploading From Eclipse

You can upload your application code and files from within Eclipse using the Google Plugin.

To upload your application from Eclipse, click the App Engine deploy button on the toolbar:

Enter your Google account username (your email address) and password when prompted, then click the Upload button. Eclipse gets the application ID and version information from the `appengine-web.xml` file, and uploads the contents of the `war/` directory.

### Uploading Using the Command Prompt

You can upload your application code and files using a command included in the SDK named `appcfg.cmd` (Windows) or `appcfg.sh` (Mac OS X, Linux).

AppCfg is a multi-purpose tool for interacting with your app on App Engine. The command takes the name of an action, the path to your app's `war/` directory, and other options. To upload the app code and files to App Engine, you use the `update` action.

To upload the app, using Windows:

    ..\appengine-java-sdk\bin\appcfg.cmd update war

To upload the app, using Mac OS X or Linux:

    ../appengine-java-sdk/bin/appcfg.sh update war

Enter your Google username and password at the prompts.

### Accessing Your Application

You can now see your application running on App Engine. If you set up a free appspot.com domain name, the URL for your website begins with your application ID:

`http://application-id.appspot.com/`

## Congratulations!

You have completed this tutorial. For more information on the subjects covered here, see the rest of the App Engine documentation.