{"title":"Troubleshooting","version":"2.1","locale":"en","docname":"faq/troubleshooting","url":"/en/2.1/faq/troubleshooting/","canonical":"https://djangodocs.dev/en/2.1/faq/troubleshooting/","summary":"This page contains some advice about errors and problems commonly encountered during the development of Django applications. Problems running django-admin Link to…","html":"

TroubleshootingLink to this heading#

\n

This page contains some advice about errors and problems commonly encountered\nduring the development of Django applications.

\n
\n

Problems running django-adminLink to this heading#

\n
\n

“command not found: django-admin”Link to this heading#

\n

django-admin should be on your system path if you\ninstalled Django via python setup.py. If it’s not on your path, you can\nfind it in site-packages/django/bin, where site-packages is a directory\nwithin your Python installation. Consider symlinking to django-admin from some place on your path, such as\n/usr/local/bin.

\n

If django-admin doesn’t work but django-admin.py does, you’re probably\nusing a version of Django that doesn’t match the version of this documentation.\ndjango-admin is new in Django 1.7.

\n
\n
\n

macOS permissionsLink to this heading#

\n

If you’re using macOS, you may see the message “permission denied” when\nyou try to run django-admin. This is because, on Unix-based systems like\nmacOS, a file must be marked as “executable” before it can be run as a program.\nTo do this, open Terminal.app and navigate (using the cd command) to the\ndirectory where django-admin is installed, then\nrun the command sudo chmod +x django-admin.

\n
\n
\n
\n

MiscellaneousLink to this heading#

\n
\n

I’m getting a UnicodeDecodeError. What am I doing wrong?Link to this heading#

\n

This class of errors happen when a bytestring containing non-ASCII sequences is\ntransformed into a Unicode string and the specified encoding is incorrect. The\noutput generally looks like this:

\n
Code
UnicodeDecodeError: 'ascii' codec can't decode byte 0x?? in position ?:\nordinal not in range(128)\n
\n

The resolution mostly depends on the context, however here are two common\npitfalls producing this error:

\n\n

Related resources:

\n\n
\n
","rootId":"troubleshooting","toc":[{"title":"Problems running django-admin","anchor":"problems-running-django-admin","children":[{"title":"“command not found: django-admin”","anchor":"command-not-found-django-admin","children":[]},{"title":"macOS permissions","anchor":"macos-permissions","children":[]}]},{"title":"Miscellaneous","anchor":"miscellaneous","children":[{"title":"I’m getting a UnicodeDecodeError. What am I doing wrong?","anchor":"i-m-getting-a-unicodedecodeerror-what-am-i-doing-wrong","children":[]}]}],"breadcrumbs":[{"docname":"faq/index","title":"Django FAQ","url":"/en/2.1/faq/"}],"prev":{"docname":"faq/contributing","title":"FAQ: Contributing code","url":"/en/2.1/faq/contributing/"},"next":{"docname":"ref/index","title":"API Reference","url":"/en/2.1/ref/"},"formats":{"html":"/en/2.1/faq/troubleshooting/","markdown":"/en/2.1/faq/troubleshooting.md","json":"/en/2.1/faq/troubleshooting.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/faq/troubleshooting.txt","official":"https://docs.djangoproject.com/en/2.1/faq/troubleshooting/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}