Cómo instalar Django

Este documento le ayudará a tener Django instalado y funcionando.

Instale Python

Django es un framework web de Python. Visite ref:faq-python-version-support para más detalles.

Obtenga la última versión de Python en https://www.python.org/download/ o con el administrador de paquetes de su sistema operativo.

Python en Windows

Si está comenzando con Django en Windows, How to install Django on Windows podría resultarle útil.

Instalar Apache y mod_wsgi

Si solo desea experimentar con Django salte a la siguiente sección; Django incluye une servidor web ligero que puede utilizar para testing, así que no será necesario configurar Apache hasta que esté listo para hacer el despliegue de Django en producción.

Si desea usar Django en un sitio en producción, utilice Apache con mod_wsgi. mod_wsgi opera en uno de dos modos: modo embebido o modo daemon. En el modo embebido, mod_wsgi es similar a mod_perl: incrusta Python dentro de Apache y carga el código Python en memoria cuando el servidor se inicia. El código permanece en memoria durante la vida del proceso de Apache, lo que conduce a mejoras significativas de rendimiento frente a otras configuraciones de servidor. En el modo daemon, mod_wsgi genera un proceso daemon independiente que se encarga de manejar las peticiones. Este proceso daemon puede ejecutarse como un usuario diferente al del servidor web, lo que puede mejorar la seguridad. Además, el proceso daemon puede reiniciarse sin necesidad de reiniciar todo el servidor web Apache, lo que facilita la actualización de la base de código. Consulte la documentación de mod_wsgi para determinar qué modo es el más adecuado para su configuración. Asegúrese de tener Apache instalado con el módulo mod_wsgi activado. Django funcionará con cualquier versión de Apache que sea compatible con mod_wsgi.

Visite How to use Django with mod_wsgi para obtener más información sobre como configurar mod_wsgi una vez lo instale.

Si no puede usar mod_wsgi por alguna razón, no tema: Django tiene soporte para otras opciones de despliegue, Una es uWSGI la cual funciona muy bien con nginx. Adicionalmente, Django sigue la especificación WSGI (PEP 3333), lo que le permite ejecutarse en una variedad de plataformas de servidores.

Configure su base de datos

Si planea usar las funcionalidades que ofrece la API de bases de datos de Django, entonces necesitará estar seguro de que un servidor de bases de datos esté en ejecución. Django admite muchos tipos diferentes de servidores de base de datos y tiene soporte oficial con PostgreSQL, MariaDB, MySQL, Oracle y SQLite.

Si está desarrollando un proyecto pequeño o algo que no planea desplegar en un entorno de producción, SQLite es generalmente la mejor opción dado que no requiere ejecutar un servidor por separado. Sin embargo, SQLite tiene muchas diferencias con otras bases de datos, por lo que si está trabajando en algo sustancial, se recomienda desarrollar con la misma base de datos que planea usar en producción.

Además de las bases de datos con soporte oficial, existen :ref:`backends ofrecidos por terceros <third-party-notes> ` que le permiten utilizar otras bases de datos con Django.

Para utilizar una base de datos diferente a SQLite , deberá asegurarse de que estén instaladas las bibliotecas de enlace de Python correspondientes para la base de datos.

• Si está utilizando PostgreSQL, necesitará el paquete psycopg o el psycopg2. Visite PostgreSQL notes para más detalles.

• Si está utilizando MySQL o MariaDB, necesitará un DB API driver como mysqlclient. Visite notes for the MySQL backend para más detalles.

• Si utilizá SQLite quizá desee leer SQLite backend notes.

• Si está usando Oracle, necesitará instalar oracledb, por favor lea antes las notas para el backend de Oracle para más detalles sobre el soporte de versiones tanto de Oracle como de oracledb.

• Si está usando algún backend no oficial de terceros, por favor consulte la documentación provista para otros requisitos adicionales.

Y asegúrese de que las siguientes claves en el item ``”default”` del diccionario DATABASES coincidan con sus configuraciones de conexión de base de datos.

• ENGINE – bien sea 'django.db.backends.sqlite3', 'django.db.backends.postgresql_psycopg2', 'django.db.backends.mysql', o 'django.db.backends.oracle'. Otros backends también están disponibles.

• NAME – El nombre de tu base de datos. Si utiliza SQLite, la base de datos será un archivo en su ordenador. En ese caso, NAME deberá ser la ruta absoluta completa, incluyendo el nombre del archivo. No necesita crear nada de antemano; el archivo de la base de datos se creará automáticamente cuando sea necesario. El valor por default, BASE_DIR / 'db.sqlite3', guardará el archivo en el directorio de su proyecto.

Para bases de datos distintas a SQLite

Si no está utilizando SQLite como su base de datos, se deben añadir ajustes adicionales tales como USER, PASSWORD, y HOST se deben añadir. Para más información, vea la documentación de referencia para DATABASES.

Asegúrese de haber creado la base de datos para este punto. Haga esto con «CREATE DATABASE database_name;» dentro de la terminal interactiva de tu base de datos.

Si planea utilizar el comando manage.py migrate para automáticamente crear las tablas de la base de datos para sus modelos (después de haber instalado Django y creado un proyecto), se tendrá que asegurar de que Django tenga permiso de crear y alterar tablas en la base de datos que esté utilizando; si planea crear manualmente las tablas , puede también dar a Django permisos de SELECT, INSERT, UPDATE y` DELETE` . Después de crear un usuario en la base de datos con estos permisos, usted especificará estos detalles en el archivo settings del proyecto, visite DATABASES  para más detalles.

Si utiliza el testing framework  de Django para probar queries a la base de datos, Django necesitará permiso para crear una base de datos de prueba.

Instalé el código de Django

Installation instructions are slightly different depending on whether you’re installing a distribution-specific package, downloading the latest official release, or fetching the latest development version.

Installing an official release with pip

This is the recommended way to install Django.

1. Install pip. The easiest is to use the standalone pip installer. If your distribution already has pip installed, you might need to update it if it’s outdated. If it’s outdated, you’ll know because installation won’t work.

2. Take a look at venv. This tool provides isolated Python environments, which are more practical than installing packages systemwide. It also allows installing packages without administrator privileges. The contributing tutorial walks through how to create a virtual environment.

3. After you’ve created and activated a virtual environment, enter the command:

   Linux/macOS

   $ python -m pip install Django
   

   Windows

   ...\> py -m pip install Django
   

Installing a distribution-specific package

Check the distribution specific notes to see if your platform/distribution provides official Django packages/installers. Distribution-provided packages will typically allow for automatic installation of dependencies and supported upgrade paths; however, these packages will rarely contain the latest release of Django.

Installing the development version

Tracking Django development

If you decide to use the latest development version of Django, you’ll want to pay close attention to the development timeline, and you’ll want to keep an eye on the release notes for the upcoming release. This will help you stay on top of any new features you might want to use, as well as any changes you’ll need to make to your code when updating your copy of Django. (For stable releases, any necessary changes are documented in the release notes.)

If you’d like to be able to update your Django code occasionally with the latest bug fixes and improvements, follow these instructions:

1. Make sure that you have Git installed and that you can run its commands from a shell. (Enter git help at a shell prompt to test this.)

2. Check out Django’s main development branch like so:

   Linux/macOS

   $ git clone https://github.com/django/django.git
   

   Windows

   ...\> git clone https://github.com/django/django.git
   

   This will create a directory django in your current directory.

3. Make sure that the Python interpreter can load Django’s code. The most convenient way to do this is to use a virtual environment and pip. The contributing tutorial walks through how to create a virtual environment.

4. After setting up and activating the virtual environment, run the following command:

   Linux/macOS

   $ python -m pip install -e django/
   

   Windows

   ...\> py -m pip install -e django\
   

   This will make Django’s code importable, and will also make the django-admin utility command available. In other words, you’re all set!

When you want to update your copy of the Django source code, run the command git pull from within the django directory. When you do this, Git will download any changes.