Another Fleet Activity Tracking tool for Alliance Auth

5.0.3 · active · verified Fri Apr 17

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.

Common errors

```
ModuleNotFoundError: No module named 'eveuniverse'
```
cause The 'django-eveuniverse' dependency was replaced by 'django-eveonline-sde' in allianceauth-afat v5.0.0.

fix Remove `django-eveuniverse` and install `django-eveonline-sde`: `pip uninstall django-eveuniverse && pip install django-eveonline-sde`.
```
django.db.utils.ProgrammingError: relation "afat_fatlink" does not exist
```
cause Database migrations for the 'afat' app have not been applied.

fix Run `python manage.py migrate` in your Alliance Auth project's virtual environment.
```
Admin panel or app pages show broken styling/JavaScript errors.
```
cause Static files (CSS, JavaScript) have not been collected or updated after installation/upgrade.

fix Run `python manage.py collectstatic` in your Alliance Auth project's virtual environment and ensure your web server serves them correctly.
```
ImproperlyConfigured: Requested setting INSTALLED_APPS, but settings have not been configured.
```
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.

fix Ensure 'afat' is correctly added to `INSTALLED_APPS` in your `settings.py` (e.g., `local.py`) and that Django is properly initialized.

Warnings

breaking 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`.
Fix: Run `pip uninstall django-eveuniverse` then `pip install django-eveonline-sde`.
breaking 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.
Fix: Ensure your Alliance Auth instance is updated to at least version 4.12.0 before installing allianceauth-afat >= 4.3.0.
gotcha 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`.
Fix: Review any custom code interacting with datetimes to ensure compatibility with `django.utils.timezone`. For new development, prefer `django.utils.timezone` functions.
gotcha 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.
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.

Install

pip install allianceauth-afat Install latest version

Imports

afat
wrong:
```
INSTALLED_APPS = ['allianceauth_afat', ...]
```
correct:
```
INSTALLED_APPS = [
    # ... other apps
    'afat',
    # ...
]
```
The app name to add to Django's INSTALLED_APPS is 'afat', not the full package name 'allianceauth_afat'.

Quickstart

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.

# In your Alliance Auth project's settings.py (e.g., local.py)
INSTALLED_APPS = [
    # ... other apps
    'afat',
    # ...
]

# After adding to INSTALLED_APPS, run these commands in your virtual environment
# python manage.py migrate
# python manage.py collectstatic
# Then restart your Gunicorn and Celery services.

view raw JSON →