Django-1.2.1/docs/faq/install.txt

   1 .. _faq-install:
   2
   3 FAQ: Installation
   4 =================
   5
   6 How do I get started?
   7 ---------------------
   8
   9     #. `Download the code`_.
  10     #. Install Django (read the :ref:`installation guide <intro-install>`).
  11     #. Walk through the :ref:`tutorial <intro-tutorial01>`.
  12     #. Check out the rest of the :ref:`documentation <index>`, and `ask questions`_ if you
  13        run into trouble.
  14
  15 .. _`Download the code`: http://www.djangoproject.com/download/
  16 .. _ask questions: http://www.djangoproject.com/community/
  17
  18 What are Django's prerequisites?
  19 --------------------------------
  20
  21 Django requires Python_, specifically any version of Python from 2.4
  22 through 2.6. No other Python libraries are required for basic Django
  23 usage.
  24
  25 For a development environment -- if you just want to experiment with Django --
  26 you don't need to have a separate Web server installed; Django comes with its
  27 own lightweight development server. For a production environment, Django
  28 follows the WSGI_ spec, which means it can run on a variety of server
  29 platforms.  See :ref:`Deploying Django <howto-deployment-index>` for some
  30 popular alternatives.  Also, the `server arrangements wiki page`_ contains
  31 details for several deployment strategies.
  32
  33 If you want to use Django with a database, which is probably the case, you'll
  34 also need a database engine. PostgreSQL_ is recommended, because we're
  35 PostgreSQL fans, and MySQL_, `SQLite 3`_, and Oracle_ are also supported.
  36
  37 .. _Python: http://www.python.org/
  38 .. _WSGI: http://www.python.org/dev/peps/pep-0333/
  39 .. _server arrangements wiki page: http://code.djangoproject.com/wiki/ServerArrangements
  40 .. _PostgreSQL: http://www.postgresql.org/
  41 .. _MySQL: http://www.mysql.com/
  42 .. _`SQLite 3`: http://www.sqlite.org/
  43 .. _Oracle: http://www.oracle.com/
  44
  45 Do I lose anything by using Python 2.4 versus newer Python versions, such as Python 2.5 or 2.6?
  46 -----------------------------------------------------------------------------------------------
  47
  48 Not in the core framework. Currently, Django itself officially supports any
  49 version of Python from 2.4 through 2.6, inclusive. However, newer versions of
  50 Python are often faster, have more features, and are better supported.
  51 Third-party applications for use with Django are, of course, free to set their
  52 own version requirements.
  53
  54 Over the next year or two Django will begin dropping support for older Python
  55 versions as part of a migration which will end with Django running on Python 3
  56 (see below for details).
  57
  58 All else being equal, we recommend that you use the latest 2.x release
  59 (currently Python 2.6). This will let you take advantage of the numerous
  60 improvements and optimizations to the Python language since version 2.4, and
  61 will help ease the process of dropping support for older Python versions on
  62 the road to Python 3.
  63
  64 Can I use Django with Python 2.3?
  65 ---------------------------------
  66
  67 Django 1.1 (and earlier) supported Python 2.3. Django 1.2 and newer does not.
  68 We highly recommend you upgrade Python if at all possible, but Django 1.1 will
  69 continue to work on Python 2.3.
  70
  71 Can I use Django with Python 3?
  72 -------------------------------
  73
  74 Not at the moment. Python 3.0 introduced a number of
  75 backwards-incompatible changes to the Python language, and although
  76 these changes are generally a good thing for Python's future, it will
  77 be a while before most Python software catches up and is able to run
  78 on Python 3.0. For larger Python-based software like Django, the
  79 transition is expected to take at least a year or two (since it
  80 involves dropping support for older Python releases and so must be
  81 done gradually).
  82
  83 In the meantime, Python 2.x releases will be supported and provided
  84 with bug fixes and security updates by the Python development team, so
  85 continuing to use a Python 2.x release during the transition should
  86 not present any risk.
  87
  88 Will Django run under shared hosting (like TextDrive or Dreamhost)?
  89 -------------------------------------------------------------------
  90
  91 See our `Django-friendly Web hosts`_ page.
  92
  93 .. _`Django-friendly Web hosts`: http://code.djangoproject.com/wiki/DjangoFriendlyWebHosts
  94
  95 Should I use the stable version or development version?
  96 -------------------------------------------------------
  97
  98 Generally, if you're using code in production, you should be using a
  99 stable release. The Django project publishes a full stable release
 100 every nine months or so, with bugfix updates in between. These stable
 101 releases contain the API that is covered by our backwards
 102 compatibility guarantees; if you write code against stable releases,
 103 you shouldn't have any problems upgrading when the next official
 104 version is released.