Skip to main content

AA Sovereignty Timer

Version License Python Django pre-commit pre-commit.ci status Code Style: black Automated Checks codecov Translation status Contributor Covenant Discord Alliance Auth Compatibility

ko-fi

Sovereignty campaign overview for Alliance Auth.



Screenshots

All Timers

AA Sov Timer DashboardAA Sov Timer (All Timers)

Upcoming Timers (Filtered)

AA Sov Timer (Upcoming Timers)

Active Timers (Filtered)

AA Sov Timer (Active Timers)

Installation

  • AA Sovereignty Timer is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official AA installation guide for details)

Bare Metal Installation

Step 1: Installing the App

Make sure you're in the virtual environment (venv) of your Alliance Auth installation. Then install the latest version:

pip install aa-sov-timer==5.2.0

Step 2: Update Your AA Settings

Configure your AA settings (local.py) as follows:

  • Modify INSTALLED_APPS to include the following entries:

    INSTALLED_APPS += [
        # ...
        "eve_sde",  # Only if not already added for another app
        "sovtimer",
        # ...
    ]
    
    # This line right below the `INSTALLED_APPS` list, and only if not already added for another app
    INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS
    
  • Add the Scheduled Tasks

    if "sovtimer" in INSTALLED_APPS:
        # AA Sovereignty Timer - Run sovereignty related updates every 30 seconds
        CELERYBEAT_SCHEDULE["sovtimer.tasks.run_sov_campaign_updates"] = {
            "task": "sovtimer.tasks.run_sov_campaign_updates",
            "schedule": 30,
        }
    
    if "eve_sde" in INSTALLED_APPS:
        # Run at 12:00 each day
        CELERYBEAT_SCHEDULE["EVE SDE :: Check for SDE Updates"] = {
            "task": "eve_sde.tasks.check_for_sde_updates",
            "schedule": crontab(minute="0", hour="12"),
        }
    
        # Set the following when you have a bare metal installation, or Docker with a
        # non-standard storage for `myauth`
        ESDE_TASK_SPLIT = True
    

Step 3: Finalizing the Installation

Copy static files and run migrations

python manage.py collectstatic
python manage.py migrate

Step 4: Preload EVE SDE Data

AA Sovereignty Timer uses EVE SDE data to map IDs to names for solar systems, regions and constellations. So you need to preload some data from SDE once. If you already have run this command, you can skip this step.

python manage.py esde_load_sde
python manage.py sovtimer_load_initial_data

Both commands might take a moment or two, so be patient ...

Step 5: Restart Supervisor

Once you have completed all previous steps, restart your AA supervisor service to apply the changes.

Continue with the Common Steps / Configuration below to finish the installation.

Docker Installation

Step 1: Add the App

Add the app to your conf/requirements.txt:

aa-sov-timer==5.2.0

Step 2: Update Your AA Settings

Configure your AA settings (conf/local.py) as follows:

  • Modify INSTALLED_APPS to include the following entries:

    INSTALLED_APPS = [
        # ...
        "eve_sde",  # Only if not already added for another app
        "sovtimer",
        # ...
    ]
    
    # This line right below the `INSTALLED_APPS` list, and only if not already added for another app
    INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS
    
  • Add the Scheduled Tasks

    if "sovtimer" in INSTALLED_APPS:
        # AA Sovereignty Timer - Run sovereignty related updates every 30 seconds
        CELERYBEAT_SCHEDULE["sovtimer.tasks.run_sov_campaign_updates"] = {
            "task": "sovtimer.tasks.run_sov_campaign_updates",
            "schedule": 30,
        }
    
    if "eve_sde" in INSTALLED_APPS:
        # Run at 12:00 each day
        CELERYBEAT_SCHEDULE["EVE SDE :: Check for SDE Updates"] = {
            "task": "eve_sde.tasks.check_for_sde_updates",
            "schedule": crontab(minute="0", hour="12"),
        }
    
        # Set the following when you have a bare metal installation, or Docker with a
        # non-standard storage for `myauth`
        ESDE_TASK_SPLIT = True
    

Step 3: Build Auth and Restart Your Containers

docker compose build --no-cache
docker compose --env-file=.env up -d

Step 4: Finalizing the Installation

Run migrations, copy static files and load EVE SDE data:

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

auth esde_load_sde
auth sovtimer_load_initial_data

Continue with the Common Steps / Configuration below to finish the installation.

Common Steps / Configuration

(Optional) Allow Public Views

This app supports AA's feature of public views.
To allow this feature, please add "sovtimer",, to the list of APPS_WITH_PUBLIC_VIEWS in your local.py or conf/local.py for Docker:

APPS_WITH_PUBLIC_VIEWS = [
    "sovtimer",
]

Restart your supervisor service or your Docker containers to apply the changes.

Updating

Bare Metal Installation

To update your existing installation of AA Sovereignty Timer, first enable your virtual environment.

Then run the following commands from your AA project directory (the one that contains manage.py).

pip install aa-sov-timer==5.2.0

python manage.py collectstatic
python manage.py migrate

Finally, restart your AA supervisor service.

Docker Installation

To update your existing installation of AA Sovereignty Timer, all you need to do is to update the respective line in your conf/requirements.txt file to the latest version.

aa-sov-timer==5.2.0

Now rebuild your containers and restart them:

docker compose build --no-cache
docker compose --env-file=.env up -d

After that, run the following commands to update your database and static files:

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

Common Steps

It is possible that some versions need some more changes. Always read the changelog and/or release notes to find out more.

Changelog

See CHANGELOG.md for a detailed list of changes and improvements.

Translation Status

Translation status

Do you want to help translate this app into your language or improve the existing translation? - Join our team of translators!

Contributing

Do you want to contribute to this project? That's cool!

Please make sure to read the Contribution Guidelines.
(I promise, it's not much, just some basics)

Metadata

Release files for aa-sov-timer 5.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aa-sov-timer 5.2.0
File Size Uploaded
aa_sov_timer-5.2.0.tar.gz 207.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for aa-sov-timer 5.2.0
File Interpreter ABI Platform
aa_sov_timer-5.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 453.1 kB

Release files / aa_sov_timer-5.2.0.tar.gz

Download URL aa_sov_timer-5.2.0.tar.gz
Size 207.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a0ffdc17536ad3d59c4c24ae767fc1011820ea65a2e56b132e196d2b86dc2c63
BLAKE2b-256 checksum
How to use checksums
49610cf12eda5f38e03076be0b056a03b3e5ac170a7ecd5de72babfa04dd0510
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Release files / aa_sov_timer-5.2.0-py3-none-any.whl

Download URL aa_sov_timer-5.2.0-py3-none-any.whl
Size 245.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b933d471460b880f043b3b4acddb325b636bd5780937a80d24d0e20df850ed28
BLAKE2b-256 checksum
How to use checksums
83c83439c3e69417628b8abad3af787c56b346de681920cc99ed45d9e9085afd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 4, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

5.2.0 This release

2 release files

5.1.1

2 release files

5.1.0

2 release files

5.0.1

2 release files

5.0.0

2 release files

4.2.0

2 release files

4.1.0

2 release files

4.0.3

2 release files

4.0.2

2 release files

4.0.1

2 release files

4.0.0

2 release files

3.5.1

2 release files

3.5.0

2 release files

3.4.0

2 release files

3.3.2

2 release files

3.3.1

2 release files

3.3.0

2 release files

3.2.1

2 release files

3.2.0

2 release files

3.1.0

2 release files

3.0.0

2 release files

2.6.2

2 release files

2.6.1

2 release files

2.6.0

2 release files

2.5.1

2 release files

2.5.0

2 release files

2.4.3

2 release files

2.4.2

2 release files

2.4.1

2 release files

2.4.0

2 release files

2.3.5

2 release files

2.3.4

2 release files

2.3.3

2 release files

2.3.2

2 release files

2.3.1

2 release files

2.3.0

2 release files

2.2.4

2 release files

2.2.3

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.12.3

2 release files

1.12.2

2 release files

1.12.0

2 release files

1.11.0

2 release files

1.10.2

2 release files

1.10.1

2 release files

1.10.0

2 release files

1.9.0

2 release files

1.8.0

2 release files

1.7.0

2 release files

1.6.0

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.8

2 release files

0.5.7

2 release files

0.5.6

2 release files

0.5.5

2 release files

0.5.4

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page