https://github.com/ppfeufer/aa-esi-status
https://github.com/ppfeufer/aa-esi-status
allianceauth django esi-status python
Last synced: 29 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/ppfeufer/aa-esi-status
- Owner: ppfeufer
- License: gpl-3.0
- Created: 2020-10-11T10:26:51.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2026-05-04T18:02:04.000Z (about 1 month ago)
- Last Synced: 2026-05-04T20:06:19.341Z (about 1 month ago)
- Topics: allianceauth, django, esi-status, python
- Language: Python
- Homepage:
- Size: 3.24 MB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://pypi.org/project/aa-esi-status/)
[](https://github.com/ppfeufer/aa-esi-status/blob/master/LICENSE)
[](https://pypi.org/project/aa-esi-status/)
[](https://pypi.org/project/aa-esi-status/)
[](https://results.pre-commit.ci/latest/github/ppfeufer/aa-esi-status/main)
[](http://black.readthedocs.io/en/latest/)
[](https://github.com/ppfeufer/aa-esi-status/actions/workflows/automated-checks.yml)
[](https://codecov.io/gh/ppfeufer/aa-esi-status)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
[](https://github.com/ppfeufer/aa-esi-status/blob/master/CODE_OF_CONDUCT.md)
[](https://discord.gg/fjnHAmk)
[](https://gitlab.com/allianceauth/allianceauth)
[](https://ko-fi.com/N4N8CL1BY)
App for Alliance Auth to show the current status of ESI and its end points.
______________________________________________________________________
- [Testimonials](#testimonials)
- [Acknowledged By CCP](#acknowledged-by-ccp)
- [Screenshots](#screenshots)
- [ESI Status Page](#esi-status-page)
- [Dashboard Widget](#dashboard-widget)
- [Installation](#installation)
- [Bare Metal Installation](#bare-metal-installation)
- [Step 1: Install the App](#step-1-install-the-app)
- [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings)
- [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)
- [Docker Installation](#docker-installation)
- [Step 1: Add the App](#step-1-add-the-app)
- [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings-1)
- [Step 3: Build Auth and Restart Your Containers](#step-3-build-auth-and-restart-your-containers)
- [Step 4: Finalizing the Installation](#step-4-finalizing-the-installation)
- [Common Steps](#common-steps)
- [(Optional) Public Views](#optional-public-views)
- [Updating](#updating)
- [Bare Metal Installation](#bare-metal-installation-1)
- [Docker Installation](#docker-installation-1)
- [Common Steps](#common-steps-1)
- [Changelog](#changelog)
- [Translation Status](#translation-status)
- [Contributing](#contributing)
______________________________________________________________________
This app is so good, that after 5 years of its existence, CCP finally acknowledged
its superiority and copied it.
This is how the dashboard widget looks like.
It shows the current status of ESI for administrative users.
> [!Important]
>
> This app is a plugin for [Alliance Auth](https://gitlab.com/allianceauth/allianceauth). \
> If you don't have Alliance Auth running already, please install it first before
> proceeding. (See the official [AA installation guide](https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html) for details)
Make sure you're in the virtual environment (venv) of your Alliance Auth installation.
Then install the latest version:
```shell
pip install aa-esi-status==3.3.5
```
#### Step 2: Update Your AA Settings
Configure your AA settings (`local.py`) as follows:
- Add `"esistatus",` to `INSTALLED_APPS`
```python
INSTALLED_APPS += [
"esistatus", # https://github.com/ppfeufer/aa-esi-status
]
```
- Add the scheduled task
```python
# AA ESI Status - https://github.com/ppfeufer/aa-esi-status
CELERYBEAT_SCHEDULE["ESI Status :: Update"] = {
"task": "esistatus.tasks.update_esi_status",
"schedule": 60,
}
```
#### Step 3: Finalizing the Installation
Run migrations & copy static files.
```shell
python manage.py collectstatic
python manage.py migrate
```
Restart your supervisor services for AA.
Add the app to your `conf/requirements.txt`:
```text
aa-esi-status==3.3.5
```
#### Step 2: Update Your AA Settings
Configure your AA settings (`conf/local.py`) as follows:
- Add `"esistatus",` to `INSTALLED_APPS`
```python
INSTALLED_APPS += [
"esistatus", # https://github.com/ppfeufer/aa-esi-status
]
```
- Add the scheduled task
```python
# AA ESI Status - https://github.com/ppfeufer/aa-esi-status
CELERYBEAT_SCHEDULE["ESI Status :: Update"] = {
"task": "esistatus.tasks.update_esi_status",
"schedule": 60,
}
```
#### Step 3: Build Auth and Restart Your Containers
```shell
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 universe data:
```shell
docker compose exec allianceauth_gunicorn bash
auth collectstatic
auth migrate
```
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`:
```python
# 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`.
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`).
```shell
pip install aa-esi-status==3.3.5
python manage.py collectstatic
python manage.py migrate
```
Now restart your AA supervisor services.
To update your existing installation of AA ESI Status, all you need to do is to
update the respective line in your `conf/requirements.txt` file to the latest version.
```text
aa-esi-status==3.3.5
```
Now rebuild your containers:
```shell
docker compose build
docker compose --env-file=.env up -d
```
After that, run the following commands to update your database and static files:
```shell
docker compose exec allianceauth_gunicorn bash
auth collectstatic
auth migrate
```
It is possible that some versions need some more changes. Always read the
[release notes](https://github.com/ppfeufer/aa-esi-status/releases) to find out more.
See [CHANGELOG.md](https://github.com/ppfeufer/aa-esi-status/blob/main/CHANGELOG.md)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
Do you want to help translate this app into your language or improve the existing
translation? - [Join our team of translators][weblate engage]!
Do you want to contribute to this project? That's cool!
Please make sure to read the [Contribution Guidelines](https://github.com/ppfeufer/aa-esi-status/blob/main/CONTRIBUTING.md).\
(I promise, it's not much, just some basics)
[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ "Weblate Translations"