aa-esi-status 2.1.0

A simple status monitor for ESI

AA ESI Status

App for Alliance Auth to show the current status of ESI and its end points.

---

• AA ESI Status
  • Screenshots
    • ESI Status Page
    • Dashboard Widget
  • Installation
    • Step 1: Install the App
    • Step 2: Update Your AA Settings
    • Step 3: Finalizing the Installation
  • (Optional) Public Views
  • Updating
  • Changelog
  • Translation Status
  • Contributing

---

Screenshots

ESI Status Page

Dashboard Widget

This is how the dashboard widget looks like. It shows the current status of ESI for administrative users.

Installation

[!NOTE]

AA ESI Status >= 2.0.0 needs at least Alliance Auth v4.0.0!

Please make sure to update your Alliance Auth instance before you install this module or update to the latest version, otherwise an update to Alliance Auth will be pulled in unsupervised.

The last version of AA ESI Status that supports Alliance Auth v3 is 1.14.2.

This app 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)

Step 1: Install the App

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

pip install aa-esi-status

Step 2: Update Your AA Settings

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

• Add "esistatus", to INSTALLED_APPS

Step 3: Finalizing the Installation

Run migrations & copy static files.

python manage.py collectstatic
python manage.py migrate

Restart your supervisor services for AA.

(Optional) Public Views

This app supports AA's feature of public views, since the ESI status is not any mission-critical information. To allow users to view the time zone conversion page without the need to log in, please add "esistatus", to the list of APPS_WITH_PUBLIC_VIEWS in your local.py:

# By default, apps are prevented from having public views for security reasons.
# To allow specific apps to have public views, add them to APPS_WITH_PUBLIC_VIEWS
#   » The format is the same as in INSTALLED_APPS
#   » The app developer must also explicitly allow public views for their app
APPS_WITH_PUBLIC_VIEWS = [
    "esistatus",  # https://github.com/ppfeufer/aa-esi-status/
]

Note

If you don't have a list for APPS_WITH_PUBLIC_VIEWS yet, then add the whole block from here. This feature has been added in Alliance Auth v3.6.0 so you might not yet have this list in your local.py.

Updating

To update your existing installation of AA ESI Status, first enable your virtual environment.

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

pip install -U aa-esi-status
python manage.py collectstatic
python manage.py migrate

Now restart your AA supervisor services.

Changelog

See CHANGELOG.md

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)