NAME
django-admin - Utility script for the Django web framework
SYNOPSIS
django-admin <action> [options]
DESCRIPTION
This utility script provides commands for creation and maintenance of
Django projects and apps.
With the exception of startproject, all commands listed below can also
be performed with the manage.py script found at the top level of each
Django project directory.
ACTIONS
cleanup
Cleans out old data from the database (only expired sessions at
the moment).
compilemessages [--locale=LOCALE]
Compiles .po files to .mo files for use with builtin gettext
support.
createcachetable [tablename]
Creates the table needed to use the SQL cache backend
dbshell
Runs the command-line client for the specified databaseENGINE.
diffsettings
Displays differences between the current settings.py and
Django’s default settings. Settings that don’t appear in the
defaults are followed by "###".
inspectdb
Introspects the database tables in the database specified in
settings.py and outputs a Django model module.
install [appname ...]
Executes sqlall for the given app(s) in the current database.
makemessages [--locale=LOCALE] [--domain=DOMAIN]
[--extension=EXTENSION] [--all] [--symlinks] [--ignore=PATTERN]
[--no-default-ignore]
Runs over the entire source tree of the current directory and
pulls out all strings marked for translation. It creates (or
updates) a message file in the conf/locale (in the django tree)
or locale (for project and application) directory.
reset [appname ...]
Executes sqlreset for the given app(s) in the current database.
runfcgi [KEY=val] [KEY=val] ...
Runs this project as a FastCGI application. Requires flup. Use
runfcgi help for help on the KEY=val pairs.
runserver [--noreload] [--adminmedia=ADMIN_MEDIA_PATH]
[port|ipaddr:port]
Starts a lightweight Web server for development.
shell [--plain]
Runs a Python interactive interpreter. Tries to use IPython, if
it’s available. The --plain option forces the use of the
standard Python interpreter even when IPython is installed.
sql [appname ...]
Prints the CREATE TABLE SQL statements for the given app
name(s).
sqlall [appname ...]
Prints the CREATE TABLE, initial-data and CREATE INDEX SQL
statements for the given model module name(s).
sqlclear [appname ...]
Prints the DROP TABLE SQL statements for the given app name(s).
sqlindexes [appname ...]
Prints the CREATE INDEX SQL statements for the given model
module name(s).
sqlinitialdata [appname ...]
Prints the initial INSERT SQL statements for the given app
name(s).
sqlreset [appname ...]
Prints the DROP TABLE SQL, then the CREATE TABLE SQL, for the
given app name(s).
sqlsequencereset [appname ...]
Prints the SQL statements for resetting PostgreSQL sequences for
the given app name(s).
startapp [appname]
Creates a Django app directory structure for the given app name
in the current directory.
startproject [projectname]
Creates a Django project directory structure for the given
project name in the current directory.
syncdb Creates the database tables for all apps in INSTALLED_APPS whose
tables haven’t already been created.
test [--verbosity] [appname ...]
Runs the test suite for the specified applications, or the
entire project if no apps are specified
validate
Validates all installed models.
OPTIONS
--version
Show program’s version number and exit.
-h, --help
Show this help message and exit.
--settings=SETTINGS
Python path to settings module, e.g. "myproject.settings.main".
If this isn’t provided, the DJANGO_SETTINGS_MODULE environment
variable will be used.
--pythonpath=PYTHONPATH
Lets you manually add a directory the Python path, e.g.
"/home/djangoprojects/myproject".
--plain
Use plain Python, not IPython, for the "shell" command.
--noinput
Do not prompt the user for input.
--noreload
Disable the development server’s auto-reloader.
--verbosity=VERBOSITY
Verbosity level: 0=minimal output, 1=normal output, 2=all
output.
--adminmedia=ADMIN_MEDIA_PATH
Specifies the directory from which to serve admin media when
using the development server.
-l, --locale=LOCALE
The locale to process when using makemessages or
compilemessages.
-d, --domain=DOMAIN
The domain of the message files (default: "django") when using
makemessages.
-e, --extension=EXTENSION
The file extension(s) to examine (default: ".html", separate
multiple extensions with commas, or use -e multiple times).
-e, --symlinks
Follows symlinks to directories when examining source code and
templates for translation strings.
-e, --ignore=PATTERN
Ignore files or directories matching this glob-style pattern.
Use multiple times to ignore more.
-e, --no-default-ignore
Don’t ignore the common private glob-style patterns ’CVS’, ’.*’
and ’*~’.
-a, --all
Process all available locales when using makemessages..SH
"ENVIRONMENT"
DJANGO_SETTINGS_MODULE
In the absence of the --settings option, this environment
variable defines the settings module to be read. It should be
in Python-import form, e.g. "myproject.settings".
SEE ALSO
Full descriptions of all these options, with examples, as well as
documentation for the rest of the Django framework, can be found on the
Django site:
http://docs.djangoproject.com/en/dev/
or in the distributed documentation.
AUTHORS/CREDITS
Originally developed at World Online in Lawrence, Kansas, USA. Refer to
the AUTHORS file in the Django distribution for contributors.
LICENSE
New BSD license. For the full license text refer to the LICENSE file in
the Django distribution.