diff --git a/docs/deploying/index.rst b/docs/deploying/index.rst index bf78275d..60b239f8 100644 --- a/docs/deploying/index.rst +++ b/docs/deploying/index.rst @@ -3,18 +3,30 @@ Deployment Options ================== -Depending on what you have available there are multiple ways to run -Flask applications. You can use the builtin server during development, -but you should use a full deployment option for production applications. -(Do not use the builtin development server in production.) Several -options are available and documented here. - -If you have a different WSGI server look up the server documentation -about how to use a WSGI app with it. Just remember that your -:class:`Flask` application object is the actual WSGI application. - -For hosted options to get up and running quickly, see -:ref:`quickstart_deployment` in the Quickstart. +While lightweight and easy to use, **Flask's built-in server is not suitable +for production** as it doesn't scale well and by default serves only one +request at a time. Some of the options available for properly running Flask in +production are documented here. + +If you want to deploy your Flask application to a WSGI server not listed here, +look up the server documentation about how to use a WSGI app with it. Just +remember that your :class:`Flask` application object is the actual WSGI +application. + + +Hosted options +-------------- + +- `Deploying Flask on Heroku `_ +- `Deploying WSGI on dotCloud `_ + with `Flask-specific notes `_ +- `Deploying Flask on Webfaction `_ +- `Deploying Flask on Google App Engine `_ +- `Sharing your Localhost Server with Localtunnel `_ + + +Self-hosted options +------------------- .. toctree:: :maxdepth: 2 diff --git a/docs/quickstart.rst b/docs/quickstart.rst index b372d094..c20d88c9 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -20,24 +20,6 @@ A minimal Flask application looks something like this:: def hello_world(): return 'Hello World!' -Just save it as :file:`hello.py` (or something similar) and run it with your Python -interpreter. Make sure to not call your application :file:`flask.py` because this -would conflict with Flask itself. - -To run the application you can either use the :command:`flask` command or -python's :option:`-m` switch with Flask:: - - $ flask -a hello run - * Running on http://127.0.0.1:5000/ - -or alternatively:: - - $ python -m flask -a hello run - * Running on http://127.0.0.1:5000/ - -Now head over to `http://127.0.0.1:5000/ `_, and you -should see your hello world greeting. - So what did that code do? 1. First we imported the :class:`~flask.Flask` class. An instance of this @@ -54,10 +36,28 @@ So what did that code do? 4. The function is given a name which is also used to generate URLs for that particular function, and returns the message we want to display in the user's browser. -5. Finally we use the Flask development server to run the local server - with our application. -To stop the server, hit control-C. +Just save it as :file:`hello.py` (or something similar) and run it with your Python +interpreter. Make sure to not call your application :file:`flask.py` because this +would conflict with Flask itself. + +To run the application you can either use the :command:`flask` command or +python's :option:`-m` switch with Flask:: + + $ flask -a hello run + * Running on http://127.0.0.1:5000/ + +or alternatively:: + + $ python -m flask -a hello run + * Running on http://127.0.0.1:5000/ + +This launches a very simple builtin server, which is good enough for testing +but probably not what you want to use in production. For deployment options see +:ref:`deployment`. + +Now head over to `http://127.0.0.1:5000/ `_, and you +should see your hello world greeting. .. _public-server: @@ -76,6 +76,7 @@ To stop the server, hit control-C. This tells your operating system to listen on all public IPs. + What to do if the Server does not Start --------------------------------------- @@ -859,6 +860,8 @@ The attached :attr:`~flask.Flask.logger` is a standard logging documentation `_ for more information. +Read more on :ref:`application-errors`. + Hooking in WSGI Middlewares --------------------------- @@ -870,24 +873,7 @@ can do it like this:: from werkzeug.contrib.fixers import LighttpdCGIRootFix app.wsgi_app = LighttpdCGIRootFix(app.wsgi_app) -.. _quickstart_deployment: - Deploying to a Web Server ------------------------- -Ready to deploy your new Flask app? To wrap up the quickstart, you can -immediately deploy to a hosted platform, all of which offer a free plan for -small projects: - -- `Deploying Flask on Heroku `_ -- `Deploying WSGI on dotCloud `_ - with `Flask-specific notes `_ - -Other places where you can host your Flask app: - -- `Deploying Flask on Webfaction `_ -- `Deploying Flask on Google App Engine `_ -- `Sharing your Localhost Server with Localtunnel `_ - -If you manage your own hosts and would like to host yourself, see the chapter -on :ref:`deployment`. +Ready to deploy your new Flask app? Go to :ref:`deployment`.