Install & Compatibility
Where this runs
tested against v? · pip install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
build_error
glibcpy 3.10–3.910 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Structure
✓ from aa_structures.models import Structure
✗ from structure_tracker.models import Structure
Class name for Eve Online structures. The module path changed in v3.0.0 from `structure_tracker` to `aa_structures` during the Alliance Auth 3.x rewrite.
AA_STRUCTURES_ENABLE_STRUCTURE_OWNERSHIP
✓ from aa_structures.app_settings import AA_STRUCTURES_ENABLE_STRUCTURE_OWNERSHIP
Example of accessing an app-specific setting directly within Python code. Most settings are configured via Django settings (e.g., in `local.py`).
To quickly integrate AA Structures into an existing Alliance Auth v3.x installation, follow these steps. This setup adds the app to your Django project, applies necessary database schema changes, and prepares static assets for the web server.
# Assuming an existing Alliance Auth v3.x installation
# 1. Install the package
# pip install aa-structures
# 2. Add 'aa_structures' to INSTALLED_APPS in your Alliance Auth local.py
# local.py
# INSTALLED_APPS = [
# ...,
# 'aa_structures'
# ]
# 3. Apply database migrations
# python manage.py migrate aa_structures
# 4. Collect static files (if not already done)
# python manage.py collectstatic --noinput
# 5. Restart Gunicorn/Celery if running in production
# systemctl restart gunicorn
# systemctl restart celery
Debug
Known issues
breakingMajor version 3.0.0 of `aa-structures` introduced breaking changes by renaming the app's internal module path from `structure_tracker` to `aa_structures` to align with Alliance Auth 3.x.fixUpdate your 'INSTALLED_APPS' from 'structure_tracker' to 'aa_structures' in `local.py`. If you were importing models or other components directly, update paths from 'structure_tracker.<module>' to 'aa_structures.<module>'. Ensure your Alliance Auth installation is also updated to v3.0.0 or higher.
affects: <3.0.0 -> >=3.0.0
gotcha`aa-structures` requires Alliance Auth v3.0.0 or higher. Installing it on an older Alliance Auth version (e.g., v2.x) will lead to compatibility issues, errors, or a non-functional app.fixBefore installing `aa-structures`, ensure your Alliance Auth installation is updated to v3.0.0 or later. Consult the Alliance Auth upgrade guide for major version upgrades.
affects: All versions
gotchaFailure to run database migrations after installing or upgrading `aa-structures` will result in database errors (e.g., 'table does not exist' or 'relation "..." does not exist') when the app tries to access its models.fixAfter adding `aa_structures` to `INSTALLED_APPS` and running `pip install aa-structures`, always execute `python manage.py migrate aa_structures` to apply database schema changes.
affects: All versions
gotchaUsers may not see the AA Structures app links or data within Alliance Auth even after successful installation if proper permissions are not configured.fixIn the Alliance Auth admin panel, navigate to 'Groups & Permissions', create or edit a group, and assign relevant `aa_structures` permissions (e.g., 'Can see structures', 'Can manage timers'). Ensure users are assigned to a group with these permissions.
affects: All versions
Upgrade
Version history
4.0.1latest on PyPI · released Jun 2, 2026
Audit
Dependencies
allianceauthrequiredCore platform dependency for the app to function. Requires Alliance Auth v3.0.0 or higher.