Alliance Auth SRP Module

4.2.3 · active · verified Fri Apr 17

aa-srp (Alliance Auth SRP Module) is a Django application designed for Alliance Auth, providing tools for managing Ship Replacement Program (SRP) requests within EVE Online communities. It allows members to submit SRP claims, which can then be reviewed and approved by management. The current version is 4.2.3, and it maintains an active release cadence with regular updates and improvements.

Common errors

```
ModuleNotFoundError: No module named 'eveuniverse'
```
cause Attempted to upgrade directly to `aa-srp` v4.0.0+ from a version older than v3.0.0 without intermediate migrations. The `eveuniverse` dependency was removed in v4.0.0, but older migrations might still reference it.

fix Downgrade to `aa-srp==3.0.0`, run `python manage.py migrate`, then upgrade to `aa-srp==4.0.0` (or latest) and run migrations again.
```
django.db.utils.OperationalError: no such column: srp_srprequest.xyz_field
```
cause Database migrations for `aa-srp` were not applied or not applied in the correct order after an update.

fix Ensure `srp` is in `INSTALLED_APPS` in `settings.py`, then run `python manage.py migrate srp` from your Alliance Auth project root. If this is an upgrade, ensure previous version-specific upgrade instructions (like v4.0.0's requirement to upgrade to v3.0.0 first) were followed.
```
RuntimeError: 'srp' is not in INSTALLED_APPS
```
cause The `srp` app has not been added to the `INSTALLED_APPS` list in the Alliance Auth `settings.py`.

fix Add `'srp'` to the `INSTALLED_APPS` list in your Alliance Auth `settings.py` file, then run `python manage.py migrate srp` and restart your Gunicorn/web server.
```
ImproperlyConfigured: Alliance Auth version 4.12.0 or higher is required to run this app.
```
cause Attempted to install `aa-srp` v3.3.0+ on an Alliance Auth instance older than 4.12.0.

fix Upgrade your Alliance Auth installation to at least version 4.12.0 before installing `aa-srp>=3.3.0`. Run `pip install -U allianceauth` within your Alliance Auth virtual environment, then restart services.

Warnings

breaking Upgrading to v4.0.0+ requires prior upgrade to v3.0.0 and running migrations. Direct upgrade from versions older than v3.0.0 to v4.0.0+ will cause migration issues due to the removal of `django-eveuniverse` dependency and squashed migrations.
Fix: Upgrade to `aa-srp==3.0.0`, run `python manage.py migrate`, then upgrade to `aa-srp==4.0.0` (or latest) and run migrations again.
breaking Version 3.3.0 and later require Alliance Auth version 4.12.0 or newer. Installing `aa-srp>=3.3.0` on an older Alliance Auth instance may pull in an unsupervised Auth update or lead to compatibility errors.
Fix: Ensure your Alliance Auth installation is at least `4.12.0` before upgrading or installing `aa-srp>=3.3.0`. Update Alliance Auth first: `pip install -U allianceauth`.
gotcha Version 4.1.0 introduced new dependencies. While `pip install aa-srp` should handle these, ensure your environment allows new packages to be installed correctly during an upgrade to prevent broken functionality.
Fix: After upgrading to `aa-srp>=4.1.0`, always run `pip install --upgrade aa-srp` to ensure all new dependencies are satisfied, then `python manage.py migrate` and restart Gunicorn.
deprecated As of version 4.2.3, a deprecated Django templatetag was replaced internally. If you have custom templates that override `aa-srp` templates, they may need to be updated if they relied on the old templatetag.
Fix: Review custom templates for `aa-srp` and update any deprecated templatetags according to Django's current best practices or by consulting the `aa-srp` source for the updated tags.

Install

pip install aa-srp Install the package
# Add 'srp' to your INSTALLED_APPS in settings.py INSTALLED_APPS = [ # ... other apps ... 'srp', # ... ] # Run migrations from your Alliance Auth project root python manage.py migrate srp # Then, restart your Gunicorn/web server process. Integrate with Alliance Auth

Imports

SrpLink, SrpRequest
```
from srp.models import SrpLink, SrpRequest
```
Commonly imported models for programmatic access or custom integrations.

Quickstart

To quickly integrate aa-srp into your Alliance Auth instance, add 'srp' to your INSTALLED_APPS, run migrations, and restart your web server.

# In your Alliance Auth project's settings.py
# Add 'srp' to your INSTALLED_APPS list
INSTALLED_APPS = [
    # ... other apps ...
    'srp',
    # ...
]

# After adding to INSTALLED_APPS, run migrations from your Auth root:
# python manage.py migrate srp
# Then restart your Gunicorn/web server process to apply changes.

view raw JSON →