# Alliance Auth Alliance service auth to help large scale alliances manage services. Built for "The 99 Percent" open for anyone to use # Installing [Ubuntu Setup Guide](installation/auth/ubuntu.md) For other distros, adapt the procedure and find distro-specific alternatives for the [dependencies](installation/auth/dependencies.md) # Using See the [Quick Start Guide](installation/auth/quickstart.md) # Troubleshooting Read the [list of common problems.](maintenance/troubleshooting.md) # Upgrading As AllianceAuth is developed, new features are added while old bugs are repaired. It’s good practice to keep your instance of AllianceAuth up to date. Some updates require specific instructions. Refer to their entry in the [changelog](maintenance/changelog.md) In general, the update process has 4 steps: - download the latest code - generate new models in the database - update current models in the database - rebuild web cache To perform each of these steps, you’ll need to be working from the console in the AllianceAuth directory. Usually `cd ~/allianceauth` Start by pulling the code changes: git pull Modify settings.py according to the changelog. For an automated upgrade, run the script: bash update.sh For a manual upgrade, execute the commands in this order: sudo pip install -r requirements.txt python manage.py migrate python manage.py collectstatic ```eval_rst .. toctree:: :maxdepth: 3 :caption: Contents features/index installation/index maintenance/index development/index ```