From cd382005067270c9b7c67c647ed2ba01ddd12bd9 Mon Sep 17 00:00:00 2001 From: Adarnof Date: Sat, 21 Apr 2018 19:49:46 -0400 Subject: [PATCH] Section for adding and removing apps. People know how to add, but tend not to migrate to zero when removing leading to integrity errors. --- docs/maintenance/project.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/maintenance/project.md b/docs/maintenance/project.md index 79214a92..832975a6 100644 --- a/docs/maintenance/project.md +++ b/docs/maintenance/project.md @@ -86,3 +86,12 @@ urlpatterns = [ url(r'', include(allianceauth.urls)), ] ``` + +## Adding and Removing Apps + +Your auth project is just a regular Django project - you can add in [other Django apps](https://djangopackages.org/) as desired. Most come with dedicated setup guides, but in general: + - add `'appname',` to your `INSTALLED_APPS` setting + - run `python manage.py migrate` + - run `python manage.py collectstatic` + +If you ever want to remove an app, you should first clear it from the database to avoid dangling foreign keys: `python manage.py migrate appname zero`. Then you can remove it from your auth project's `INSTALLED_APPS` list. \ No newline at end of file