{"id":9455,"library":"allianceauth-afat","title":"Another Fleet Activity Tracking tool for Alliance Auth","description":"allianceauth-afat, currently at version 5.0.3, is an application for Alliance Auth that provides tools for tracking fleet activity within EVE Online. It allows users to manage and record fleet operations for EVE Online corporations and alliances. The project maintains an active development pace with frequent patch and minor releases, ensuring compatibility with the latest Alliance Auth versions.","status":"active","version":"5.0.3","language":"en","source_language":"en","source_url":"https://github.com/ppfeufer/allianceauth-afat","tags":["django","alliance-auth","eve-online","fleet-management","app"],"install":[{"cmd":"pip install allianceauth-afat","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Required for EVE Online static data; replaced 'django-eveuniverse' in v5.0.0.","package":"django-eveonline-sde","optional":false},{"reason":"This is an app for the Alliance Auth framework; requires AA >= 4.12.0 for v4.3.0 and newer.","package":"AllianceAuth","optional":false},{"reason":"Underlying framework dependency, explicitly requires Python <3.14, >=3.10.","package":"Django","optional":false}],"imports":[{"note":"The app name to add to Django's INSTALLED_APPS is 'afat', not the full package name 'allianceauth_afat'.","wrong":"INSTALLED_APPS = ['allianceauth_afat', ...]","symbol":"afat","correct":"INSTALLED_APPS = [\n    # ... other apps\n    'afat',\n    # ...\n]"}],"quickstart":{"code":"# In your Alliance Auth project's settings.py (e.g., local.py)\nINSTALLED_APPS = [\n    # ... other apps\n    'afat',\n    # ...\n]\n\n# After adding to INSTALLED_APPS, run these commands in your virtual environment\n# python manage.py migrate\n# python manage.py collectstatic\n# Then restart your Gunicorn and Celery services.","lang":"python","description":"To integrate allianceauth-afat into your Alliance Auth installation, add 'afat' to your project's INSTALLED_APPS in settings.py. Afterwards, apply database migrations and collect static files, then restart your application services."},"warnings":[{"fix":"Run `pip uninstall django-eveuniverse` then `pip install django-eveonline-sde`.","message":"Version 5.0.0 introduced a breaking dependency change: `django-eveuniverse` was replaced by `django-eveonline-sde`. You must update your environment to install `django-eveonline-sde` and remove `django-eveuniverse`.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Ensure your Alliance Auth instance is updated to at least version 4.12.0 before installing allianceauth-afat >= 4.3.0.","message":"Versions 4.3.0 and newer require Alliance Auth version 4.12.0 or higher. Installing on an older Alliance Auth instance will lead to functionality issues or pull in an unsupervised AA update.","severity":"breaking","affected_versions":">=4.3.0"},{"fix":"Review any custom code interacting with datetimes to ensure compatibility with `django.utils.timezone`. For new development, prefer `django.utils.timezone` functions.","message":"Starting with version 5.0.2, the library moved away from `django.utils.datetime_safe` to `django.utils.timezone`. While this prepares for future Alliance Auth versions, custom extensions or direct usage of `datetime_safe` might cause unexpected behavior if not aligned with `django.utils.timezone`.","severity":"gotcha","affected_versions":">=5.0.2"},{"fix":"Run `python manage.py migrate` and `python manage.py collectstatic` in your project's virtual environment after every update. Restart your Gunicorn/uWSGI and Celery services.","message":"After updating the application, especially across major versions, it's crucial to run `python manage.py migrate` and `python manage.py collectstatic` to apply database schema changes and update static assets.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Remove `django-eveuniverse` and install `django-eveonline-sde`: `pip uninstall django-eveuniverse && pip install django-eveonline-sde`.","cause":"The 'django-eveuniverse' dependency was replaced by 'django-eveonline-sde' in allianceauth-afat v5.0.0.","error":"ModuleNotFoundError: No module named 'eveuniverse'"},{"fix":"Run `python manage.py migrate` in your Alliance Auth project's virtual environment.","cause":"Database migrations for the 'afat' app have not been applied.","error":"django.db.utils.ProgrammingError: relation \"afat_fatlink\" does not exist"},{"fix":"Run `python manage.py collectstatic` in your Alliance Auth project's virtual environment and ensure your web server serves them correctly.","cause":"Static files (CSS, JavaScript) have not been collected or updated after installation/upgrade.","error":"Admin panel or app pages show broken styling/JavaScript errors."},{"fix":"Ensure 'afat' is correctly added to `INSTALLED_APPS` in your `settings.py` (e.g., `local.py`) and that Django is properly initialized.","cause":"Attempting to use Django components outside of a configured Django environment or before settings are loaded, or the app name in INSTALLED_APPS is incorrect.","error":"ImproperlyConfigured: Requested setting INSTALLED_APPS, but settings have not been configured."}]}