1.. _tutorials.gettingstarted.uploading:
2
3Uploading Your Application
4==========================
5You create and manage applications in App Engine using the Administration
6Console. Once you have registered an application ID for your application, you
7upload it to your website using ``appcfg.py``, a command-line tool provided
8in the SDK. Or, if you're using Google App Engine Launcher, you can upload
9your application by clicking the Deploy button.
10
11.. note::
12   Once you register an application ID, you can delete it, but you can't
13   re-register that same application ID after it has been deleted. You can
14   skip these next steps if you don't want to register an ID at this time.
15
16
17Registering the Application
18---------------------------
19You create and manage App Engine web applications from the App Engine
20Administration Console, at the following URL:
21
22- `https://appengine.google.com/ <https://appengine.google.com/>`_
23
24Google App Engine Launcher users can reach this URL by clicking the Dashboard
25button.
26
27Sign in to App Engine using your Google account. If you do not have a Google
28account, you can `create a Google account <https://www.google.com/accounts/>`_
29with an email address and password.
30
31To create a new application, click the "Create an Application" button. Follow
32the instructions to register an application ID, a name unique to this
33application. If you elect to use the free appspot.com domain name, the full
34URL for the application will be ``http://application-id.appspot.com/``. You can
35also purchase a top-level domain name for your app, or use one that you have
36already registered.
37
38Edit the ``app.yaml`` file, then change the value of the ``application:``
39setting from ``helloworld`` to your registered application ID.
40
41
42Uploading the Application
43-------------------------
44To upload your finished application to Google App Engine, run the following
45command::
46
47.. code-block:: text
48
49   appcfg.py update helloworld/
50
51Or click Deploy in Google App Engine Launcher.
52
53Enter your Google username and password at the prompts.
54
55You can now see your application running on App Engine. If you set up a free
56appspot.com domain name, the URL for your website begins with your application
57ID::
58
59.. code-block:: text
60
61   http://application-id.appspot.com
62
63
64Congratulations!
65----------------
66You have completed this tutorial. For more information on the subjects
67covered here, see the rest of
68`the App Engine documentation <http://code.google.com/appengine/docs/>`_ and
69the :ref:`guide.index`.
70