django-admin(1) 														   django-admin(1)

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

       createsuperuser [--username=USERNAME] [--email=EMAIL]
	      Creates a superuser account (a user who has all permissions).

       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 "###".

       dumpdata [--all] [--format=FMT] [--indent=NUM] [--natural=NATURAL] [appname appname appname.Model ...]
	      Outputs to standard output all data in the database associated with the named application(s).

       flush  Returns the database to the state it was in immediately after syncdb was executed.

       inspectdb
	      Introspects the database tables in the database specified in settings.py and outputs a Django model module.

       loaddata [fixture fixture ...]
	      Searches for and loads the contents of the named fixture into the database.

       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]
       [--no-wrap] [--no-location]
	      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] [--nothreading] [--nostatic] [--insecure] [--ipv6] [--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).

       sqlcustom [appname ...]
	      Prints the custom SQL statements for the given app name(s).

       sqlflush [appname ...]
	      Prints the SQL statements that would be executed for the "flush" command.

       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 [--template=PATH_OR_URL] [--extension=EXTENSION] [--name=FILENAME] [appname] [destination]
	      Creates a Django app directory structure for the given app name in the current directory or the optional destination.

       startproject [--template=PATH_OR_URL] [--extension=EXTENSION] [--name=FILENAME] [projectname] [destination]
	      Creates a Django project directory structure for the given project name in the current directory or the optional destination.

       syncdb Creates the database tables for all apps in INSTALLED_APPS whose tables haven't already been created.

       test [--verbosity] [--failfast] [appname ...]
	      Runs the test suite for the specified applications, or the entire project if no apps are specified

       testserver [--addrport=ipaddr|port] [fixture fixture ...]
	      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 vari-
	      able 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.

       --nostatic
	      Disable automatic serving of static files from STATIC_URL.

       --nothreading
	      Disable the development server's threading.

       --insecure
	      Enables serving of static files even if DEBUG is False.

       --ipv6 Enables IPv6 addresses.

       --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.

       --traceback
	      By  default,  django-admin.py will show a simple error message whenever an error occurs. If you specify this option, django-admin.py
	      will output a full stack trace whenever an exception is raised.

       -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 (separate multiple extensions with commas, or use -e multiple times) (makemessages command).

       -s, --symlinks
	      Follows symlinks to directories when examining source code and templates for translation strings (makemessages command).

       -i, --ignore=PATTERN
	      Ignore files or directories matching this glob-style pattern. Use multiple times to ignore more (makemessages command).

       --no-default-ignore
	      Don't ignore the common private glob-style patterns 'CVS', '.*' and '*~' (makemessages command).

       --no-wrap
	      Don't break long message lines into several lines (makemessages command).

       --no-location
	      Don't write '#: filename:line' comment lines in language files (makemessages command).

       -a, --all
	      Process all available locales when using makemessages.

       --template=PATH_OR_URL
	      The file or directory path or URL to load the project and app templates from.

       -n, --name=FILENAME
	      The name of an additional file to render when using app and project templates.

       --database=DB
	      Used to specify the database on which a command will operate. If not specified, this option will default to an alias of "default".

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.

Django Project							    March 2008							   django-admin(1)