AA3 wraps up a series of major updates to our dependencies

• Drops support for Python 3.7
  
• Drops Django-Redis-Cache for Django-Redis>=5.2.0
  
• Django >=4.0
  
• Celery >=5.2
  
• Redis-py >=4.0
  

Community Apps will likely require updating before moving to AA 3, a compatibility tracker is available here https://gitlab.com/allianceauth/allianceauth/-/issues/1332

Apps known to stop working with 3.0.0. You must remove or transition away from these apps before updating to 3.0.0

• ImicusFAT (Alternative AFAT)
  
• AA Buyback (Alternative AA Buyback Program)
  

Updating

• Activate your venv
  
• Check your Community Apps for compatibility, and update them.
  
• Remove or transition away from unsupported community apps (like ImicusFAT and AA Buyback)
  
• Check your Python version is >=3.8 with python --version, https://allianceauth.readthedocs.io/en/v2.15.1/installation/upgrade_python.html
  
• Remove packages AA is replacing pip uninstall django-redis-cache sleekxmpp
  
• Update AA with pip install --upgrade allianceauth>=3.0.0
  
• allianceauth update /home/allianceserver/myauth
  

Manual changes that need to be applied:

• nano myauth/myauth/urls.py
  
• Change from django.conf.urls import include, url to from django.conf.urls import include
  
• Add from django.urls import re_path right below the changed line
  
• Look for any instance of url(...) and replace it with re_path(...)
  
• python /home/allianceserver/myauth/manage.py migrate
  
• python /home/allianceserver/myauth/manage.py collectstatic
  
• supervisorctl restart myauth:
  

Changes included in AA v3.1.0 included here as fixes

• nano myauth/myauth/settings/local.py
  

• Add the following lines, adjusting as necessary (Ideally directly below SITE_NAME).
  ```python

  This is your website's URL, set it accordingly

  SITE_URL = "https://example.com"

Django security

CSRF_TRUSTED_ORIGINS = [SITE_URL]
```

Whats New

• Persistent User Settings, Language and Night_Mode https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1333
  
• Significant Korean translation updates
  

Changes

• Major dependency uplift, Django, Redis, Celery, Python 3.8+ https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1387
  
• Minor depdency bumps django-celery-beat, django-registration, django-esi for django 4.x and minor dependency management https://gitlab.com/allianceauth/allianceauth/-/commit/3b539c85775e0ebc831de7899109d4c03bf3d4fe
  
• Backwards Compatible bundles for core AA JS https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1436
  

Fixes

• Character Names are no longer Unique (as they are not in Eve Online) https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1392
  
• Fix Ghost Mumble migrations https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1416
  
• Add a bottom margin to pages to prevent elements from gluing to the bottom https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1415
  
• Remove deprecated settings https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1407
  
• Link "Latest Stable" and "Latest Pre-Release" versions to their tags on GitLab https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1405
  
• SMF 2.1 Compatability https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1432
  
• Template cleanups, adding Alt Tags, HTML fixes, CSS updates and unneccessary tags removed https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1443
  
• Search results are not duplicated for multiple characters https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1444
  
• Timerboard planet_moon is not a mandatory field in the admin backend, to match the form. https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1441
  

Dev

• SleekXMPP Discontinued, Swap to slixmpp https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1399
  
• Swap from django-redis-cache to django-redis https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1394
  
• Use proper HTML5 tags instead of self-closing XML/(X)HTML tags https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1398
  
• Move to setup.cfg instead of setup.py https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1408
  
• Add build test to downloadable artifacts https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1424
  
• Installation Guide no longer assumes root, and should highlight when Sudo-ing is appropriate, or when commands should be run as allianceserver. https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1390
  
• Drop support for Centos 8, Ubuntu 1604. Adds Stream 8, Stream 9 and Ubuntu 2204
  
• Updates all our recommended versions for Services, system packages and python
  

Breaking Notices for developers

• Character Names are no longer unique https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1392
  
• Raw Redis client access has changed https://gitlab.com/allianceauth/allianceauth/-/issues/1325 improved in https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1428
  
• AA Static Files are now prefixed with /allianceauth/ https://gitlab.com/allianceauth/allianceauth/-/merge_requests/1433
  
• Django 4.0 has a few minor common breaking changes
  
  • urls https://docs.djangoproject.com/en/4.0/releases/3.1/#id2
    
  • uggettext https://docs.djangoproject.com/en/4.0/releases/3.0/#id3
    

3.0.0 includes all changes from 2.15.1 and earlier

Docker Image Tag: registry.gitlab.com/allianceauth/allianceauth/auth:v3.0.0.