mirror of
https://gitlab.com/allianceauth/allianceauth.git
synced 2025-07-09 12:30:15 +02:00
Docs Updates
This commit is contained in:
parent
dc97fb1cc5
commit
0d67673542
@ -16,8 +16,8 @@ In addition all tools described in this guide are open source or free software.
|
|||||||
The development environment consists of the following components:
|
The development environment consists of the following components:
|
||||||
|
|
||||||
- Visual Studio Code with Remote WSL and Python extension
|
- Visual Studio Code with Remote WSL and Python extension
|
||||||
- WSL with Ubunutu 18.04. LTS
|
- WSL with Ubuntu 18.04. LTS
|
||||||
- Python 3.6 environment on WSL
|
- Python 3.7 environment on WSL
|
||||||
- MySQL server on WSL
|
- MySQL server on WSL
|
||||||
- Redis on WSL
|
- Redis on WSL
|
||||||
- Alliance Auth on WSL
|
- Alliance Auth on WSL
|
||||||
@ -71,7 +71,7 @@ sudo apt-get install gettext
|
|||||||
|
|
||||||
### Install Python
|
### Install Python
|
||||||
|
|
||||||
For AA we want to develop with Python 3.6, because that provides the maximum compatibility with today's AA installations. This also happens to be the default Python 3 version for Ubuntu 18.04. at the point of this writing.
|
For AA we want to develop with Python 3.7, because that provides the maximum compatibility with today's AA installations.
|
||||||
|
|
||||||
```eval_rst
|
```eval_rst
|
||||||
.. hint::
|
.. hint::
|
||||||
@ -80,7 +80,7 @@ For AA we want to develop with Python 3.6, because that provides the maximum com
|
|||||||
|
|
||||||
```eval_rst
|
```eval_rst
|
||||||
.. note::
|
.. note::
|
||||||
Should your Ubuntu come with a newer version of Python we recommend to still setup your dev environment with the oldest Python 3 version supported by AA, e.g Python 3.6
|
Should your Ubuntu come with a newer version of Python we recommend to still setup your dev environment with the oldest Python 3 version supported by AA, e.g Python 3.7
|
||||||
You an check out this `page <https://askubuntu.com/questions/682869/how-do-i-install-a-different-python-version-using-apt-get/1195153>`_ on how to install additional Python versions on Ubuntu.
|
You an check out this `page <https://askubuntu.com/questions/682869/how-do-i-install-a-different-python-version-using-apt-get/1195153>`_ on how to install additional Python versions on Ubuntu.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -18,28 +18,57 @@ This document describes how to install **Alliance Auth** from scratch.
|
|||||||
|
|
||||||
Alliance Auth can be installed on any Unix like operating system. Dependencies are provided below for two of the most popular Linux platforms: Ubuntu and CentOS. To install on your favorite flavour of Linux, identify and install equivalent packages to the ones listed here.
|
Alliance Auth can be installed on any Unix like operating system. Dependencies are provided below for two of the most popular Linux platforms: Ubuntu and CentOS. To install on your favorite flavour of Linux, identify and install equivalent packages to the ones listed here.
|
||||||
|
|
||||||
```eval_rst
|
|
||||||
.. hint::
|
|
||||||
CentOS: A few packages are included in a non-default repository. Add it and update the package lists. ::
|
|
||||||
|
|
||||||
yum -y install https://centos7.iuscommunity.org/ius-release.rpm
|
|
||||||
yum update
|
|
||||||
```
|
|
||||||
|
|
||||||
### Python
|
### Python
|
||||||
|
|
||||||
Alliance Auth requires Python 3.6 or higher. Ensure it is installed on your server before proceeding.
|
Alliance Auth requires Python 3.7 or higher. Ensure it is installed on your server before proceeding.
|
||||||
|
|
||||||
Ubuntu:
|
Ubuntu 1604 1804:
|
||||||
|
|
||||||
```bash
|
```eval_rst
|
||||||
apt-get install python3 python3-dev python3-venv python3-setuptools python3-pip
|
.. note::
|
||||||
|
Ubuntu 2004 ships with Python 3.8, No updates required.
|
||||||
```
|
```
|
||||||
|
|
||||||
CentOS:
|
```bash
|
||||||
|
add-apt-repository ppa:deadsnakes/ppa
|
||||||
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
yum install python36u python36u-devel python36u-setuptools python36u-pip
|
apt-get update
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
apt-get install python3.7 python3.7-dev python3.7-venv
|
||||||
|
```
|
||||||
|
|
||||||
|
CentOS 7/8:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd ~
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo yum install gcc openssl-devel bzip2-devel libffi-devel wget
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
wget https://www.python.org/ftp/python/3.7.11/Python-3.7.11.tgz
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
tar xvf Python-3.7.11.tgz
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd Python-3.7.11/
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./configure --enable-optimizations --enable-shared
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make altinstall
|
||||||
```
|
```
|
||||||
|
|
||||||
### Database
|
### Database
|
||||||
@ -155,7 +184,7 @@ python3 -m venv /home/allianceserver/venv/auth/
|
|||||||
|
|
||||||
```eval_rst
|
```eval_rst
|
||||||
.. warning::
|
.. warning::
|
||||||
The python3 command may not be available on all installations. Try a specific version such as ``python3.6`` if this is the case.
|
The python3 command may not be available on all installations. Try a specific version such as ``python3.7`` if this is the case.
|
||||||
```
|
```
|
||||||
|
|
||||||
```eval_rst
|
```eval_rst
|
||||||
|
@ -53,15 +53,15 @@ sudo yum install gcc openssl-devel bzip2-devel libffi-devel wget
|
|||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
wget https://www.python.org/ftp/python/3.7.10/Python-3.7.10.tgz
|
wget https://www.python.org/ftp/python/3.7.11/Python-3.7.11.tgz
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
tar xvf Python-3.7.10.tgz
|
tar xvf Python-3.7.11.tgz
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd Python-3.7.10/
|
cd Python-3.7.11/
|
||||||
```
|
```
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@ -182,7 +182,7 @@ mv /home/allianceserver/venv/auth /home/allianceserver/venv/auth_old
|
|||||||
|
|
||||||
## Create your new venv
|
## Create your new venv
|
||||||
|
|
||||||
Now let's create our new venv with Python 3.6 and activate it:
|
Now let's create our new venv with Python 3.7 and activate it:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3.7 -m venv /home/allianceserver/venv/auth
|
python3.7 -m venv /home/allianceserver/venv/auth
|
||||||
|
Loading…
x
Reference in New Issue
Block a user