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.

Note: Once you register an application ID, you can delete it, but you can't re-register that same application ID after it has been deleted. You can skip these next steps if you don't want to register an ID at this time.

## Registering the Application

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

https://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.

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

For this tutorial, you should probably elect to use the free appspot.com domain name, and so the full URL for the application will be `http://your_app_id.appspot.com/`. You can also purchase a top-level domain name for your app, or use one that you have already registered.

For Authentication Options (Advanced), the default option, "Open to all Google Accounts users", is the simplest choice for this tutorial. If you choose "Restricted to the following Google Apps domain", then your domain administrator must add your new app as a service on that domain. If you choose the Google Apps domain authentication option, then failure to add your app to your Google Apps domain will result in an HTTP 500 where the stack trace shows the error "Unexpected exception from servlet: java.lang.IllegalArgumentException: The requested URL was not allowed: /guestbook.jsp". If you see this error, add the app to your domain. See Configuring Google Apps to Authenticate on Appspot for instructions.

## Uploading the Application

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

Currently, you can only upload applications with a maximum size of 32 megabytes.

### 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://your_app_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.