Este documento te ayudará a empezar con Django.
Django es un marco de trabajo web para Python. Consulta ¿Qué versión de Python puedo usar con Django? para obtener más detalles.
Obtén la última versión de Python en https://www.python.org/downloads/ o con el administrador de paquetes de tu sistema operativo.
Python en Windows
Si estás empezando con Django y usas Windows, puede que encuentres útil Cómo instalar Django en Windows.
mod_wsgi¶Si solo quieres experimentar con Django, salta al siguiente apartado; Django incluye un servidor web ligero que puedes usar para probar, por lo que no necesitarás configurar Apache hasta que estés listo para desplegar Django en producción.
Si deseas usar Django en un sitio de producción, usa Apache con mod_wsgi. mod_wsgi opera en uno de dos modos: modo incorporado o modo demonio. En el modo incorporado, mod_wsgi es similar a mod_perl – se inserta Python dentro de Apache y carga el código Python en memoria cuando arranca el servidor. El código permanece en memoria durante toda la vida de un proceso de Apache, lo que conduce a ganancias significativas en rendimiento frente a otras arreglos de servidores. En modo demonio, mod_wsgi lanza un proceso demonio independiente que maneja las solicitudes. El proceso demonio puede ejecutarse como un usuario diferente al servidor web, lo que podría conducir a una mayor seguridad. El proceso demonio se puede reiniciar sin reiniciar el servidor web Apache completo, lo que podría hacer que refrescar tu base de código sea más suave. Consulta la documentación de mod_wsgi para determinar cuál es el modo adecuado para tu configuración. Asegúrate de tener instalado Apache con el módulo mod_wsgi activado. Django funcionará con cualquier versión de Apache que admita mod_wsgi.
Consulte Cómo usar Django con mod_wsgi para obtener información sobre cómo configurar mod_wsgi una vez que esté instalado.
Si no puedes usar mod_wsgi por alguna razón, no te preocupes: Django admite muchas otras opciones de despliegue. Una es uWSGI; funciona muy bien con nginx. Además, Django sigue la especificación WSGI (PEP 3333), lo que le permite ejecutarse en una variedad de plataformas de servidores.
Si planeas usar la funcionalidad del API de bases de datos de Django, necesitarás asegurarte de que un servidor de bases de datos esté ejecutándose. Django admite muchos diferentes servidores de bases de datos y está oficialmente soportado con PostgreSQL, MariaDB, MySQL, Oracle y SQLite.
Si estás desarrollando un proyecto pequeño o algo que no planeas desplegar en un entorno de producción, SQLite es generalmente la mejor opción ya que no requiere ejecutar un servidor separado. Sin embargo, SQLite tiene muchas diferencias con otras bases de datos, por lo que si estás trabajando en algo sustancial, se recomienda desarrollar con la misma base de datos que planeas usar en producción.
Además de las bases de datos oficialmente soportadas, hay backends proporcionados por terceros que te permiten utilizar otras bases de datos con Django.
Para utilizar otra base de datos diferente a SQLite, necesitarás asegurarte de que estén instaladas las ligas de Python para la base de datos adecuada:
Si estás utilizando PostgreSQL, necesitarás el paquete psycopg o psycopg2. Consulta los apuntes sobre PostgreSQL para obtener más detalles.
Si estás utilizando MySQL o MariaDB, necesitarás un driver de API de base de datos como mysqlclient. Verifica los apuntes del backend de MySQL para obtener más detalles.
Si estás utilizando SQLite, podrías querer leer los apuntes sobre el backend de SQLite.
Si estás utilizando Oracle, necesitarás instalar oracledb, pero por favor lee los apuntes del backend de Oracle para obtener más detalles sobre las versiones soportadas tanto de Oracle como de oracledb.
Si estás utilizando un backend de terceros no oficial, consulta la documentación proporcionada para cualquier requisito adicional.
Y asegúrate de que las siguientes claves en el elemento 'default' del diccionario DATABASES coincidan con tus configuraciones de conexión a la base de datos:
ENGINE – O 'django.db.backends.sqlite3', 'django.db.backends.postgresql', 'django.db.backends.mysql' o 'django.db.backends.oracle'. Otros backends están disponibles.
NOMBRE – El nombre de tu base de datos. Si estás utilizando SQLite, la base de datos será un archivo en tu computadora. En ese caso, NOMBRE debería ser el camino absoluto completo, incluyendo el nombre del archivo de ese archivo. No necesitas crear nada con anterioridad; el archivo de la base de datos se creará automáticamente cuando sea necesario. El valor por defecto, BASE_DIR / 'db.sqlite3', almacenará el archivo en tu directorio de proyecto.
Para bases de datos distintas a SQLite
Si no estás utilizando SQLite como tu base de datos, debes agregar configuraciones adicionales como USUARIO, CONTRASEÑA y HOST. Para más detalles, consulta la documentación de referencia para BASES DE DATOS.
También asegúrate de haber creado la base de datos en este punto. Hazlo con «CREAR BASE DE DATOS nombre_de_la_base;» dentro del prompt interactivo de tu base de datos.
Si planeas utilizar el comando manage.py migrate de Django para crear automáticamente las tablas de la base de datos para tus modelos (después de instalar primero Django y crear un proyecto), debes asegurarte de que Django tenga permiso para crear y alterar tablas en la base de datos que estás utilizando; si planeas crear manualmente las tablas, puedes otorgar a Django permisos SELECT, INSERT, UPDATE y DELETE. Después de crear un usuario de la base de datos con estos permisos, especificarás los detalles en el archivo de configuración de tu proyecto, consulta BASES DE DATOS para más detalles.
Si estás utilizando el marco de pruebas de Django </topics/testing/index> para probar consultas de la base de datos, Django necesitará permiso para crear una base de datos de prueba.
Las instrucciones de instalación son ligeramente diferentes dependiendo de si estás instalando un paquete específico de distribución, descargando la última versión oficial o obteniendo la última versión de desarrollo.
pip¶Esto es el método recomendado para instalar Django.
Instala pip. La forma más fácil es utilizar el instalador de pip independiente _. Si tu distribución ya tiene instalado pip, es posible que debas actualizarlo si está desactualizado. Si está desactualizado, sabrás porque la instalación no funcionará.
Mira venv. Esta herramienta proporciona entornos de Python aislados, que son más prácticos que instalar paquetes en el sistema. También permite instalar paquetes sin privilegios de administrador. El tutorial de contribución contribuyendo muestra cómo crear un entorno virtual.
Después de haber creado y activado un entorno virtual, introduce la siguiente orden:
$ python -m pip install Django
Revisa las notas sobre distribuciones específicas </misc/distribuciones> para ver si tu plataforma/distribución proporciona paquetes oficiales/DJango instaladores. Los paquetes proporcionados por la distribución permitirán a menudo la instalación automática de dependencias y caminos de actualización soportados; sin embargo, estos paquetes raramente contendrán la última versión de Django.
Seguimiento del desarrollo de Django
Si decides utilizar la última versión de desarrollo de Django, querrás prestar mucha atención a la cronología de desarrollo y mantener un ojo en las notas de liberación para la próxima liberación. Esto te ayudará a mantenerse al día con cualquier nueva característica que puedas querer utilizar, así como con cualquier cambio que debas realizar en tu código cuando actualices tu copia de Django. (Para versiones estables, cualquier cambio necesario se documenta en las notas de liberación.)
Si deseas poder actualizar ocasionalmente tu código de Django con los últimos arreglos de errores y mejoras, sigue estas instrucciones:
Asegúrate de que tienes instalado Git y que puedes ejecutar sus comandos desde una consola. (Introduce git help en una línea de comando para probar esto.)
Revisa la rama principal de desarrollo de Django de esta manera:
$ git clone https://github.com/django/django.git
Esto creará un directorio django en tu directorio actual.
Asegúrate de que el intérprete de Python pueda cargar el código de Django. La forma más conveniente de hacer esto es utilizar un entorno virtual y pip. El tutorial de contribución muestra cómo crear un entorno virtual.
Después de configurar y activar el entorno virtual, ejecuta la siguiente orden:
$ python -m pip install -e django/
Esto hará que el código de Django sea importable, y también hará disponible la utilidad comando django-admin. En otras palabras, ¡estás listo!
Cuando quieras actualizar tu copia del código fuente de Django, ejecuta la orden git pull desde dentro del directorio django. Cuando hagas esto, Git descargará cualquier cambio.
may 31, 2026