Installing¶
Caution
Supported operating systems:
Debian 9 or later
Ubuntu Bionic or later
RHEL 8 or later
Other Linux-based systems might work, but you’ll have to use manual installation method.
Automatic Installation in virtual environment¶
It’s actually the recommended method in order to avoid the error “externally managed environment” in pip with newer versions of Debian (12 and above) and Ubuntu (24.04 and above):
curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install-venv.sh | sudo bash -s -
If you get an empty response after login, please try to upgrade gipc and gevent:
/opt/ajenti/bin/python3 -m pip install gipc gevent -U
If the certificate for https is missing, simply run:
/opt/ajenti/bin/python3 /opt/ajenti/bin/ajenti-ssl-gen $(hostname)
Automatic Installation¶
This installation method will attempt to install Ajenti at OS level, and this will not work under newer versions of Debian and Ubuntu, this is not recommended anymore. Please prefer the virtual environment installation above. This should work for all other operating systems.
curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install.sh | sudo bash -s -
Manual Installation¶
Native dependencies: Debian/Ubuntu¶
Enable Universe repository (Ubuntu only):
sudo add-apt-repository universe
sudo apt-get install build-essential python3-pip python3-dev python3-lxml libssl-dev python3-dbus python3-augeas python3-apt ntpdate
Native dependencies: RHEL¶
Enable EPEL repository:
sudo dnf install epel-release
sudo dnf install -y gcc python3-devel python3-pip python3-pillow python3-augeas python3-dbus chrony openssl-devel redhat-lsb-core
Install Ajenti 2¶
Upgrade PIP:
sudo pip3 install setuptools pip wheel -U
Minimal install:
sudo pip3 install ajenti-panel ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.settings ajenti.plugin.plugins
With all plugins:
sudo pip3 install ajenti-panel ajenti.plugin.ace ajenti.plugin.augeas ajenti.plugin.auth-users ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.datetime ajenti.plugin.filemanager ajenti.plugin.filesystem ajenti.plugin.network ajenti.plugin.notepad ajenti.plugin.packages ajenti.plugin.passwd ajenti.plugin.plugins ajenti.plugin.power ajenti.plugin.services ajenti.plugin.settings ajenti.plugin.terminal
Uninstall Ajenti 2¶
Ajenti is a collection of Python modules installed with pip, delivered with an init script ( systemd or sysvinit ). So it’s necessary to remove the init script, then the Python librairies, and the configurations files.
Systemd¶
sudo systemctl stop ajenti.service
sudo systemctl disable ajenti.service
sudo systemctl daemon-reload
sudo rm -f /lib/systemd/system/ajenti.service
SysVinit¶
/etc/init.d/ajenti stop
rm -f /etc/init/ajenti.conf
Python3 modules¶
List all modules from Ajenti:
sudo pip3 list | grep aj
The result should be something like ( eventually more or less plugins ):
aj 2.1.43
ajenti-panel 2.1.43
ajenti.plugin.ace 0.30
ajenti.plugin.auth-users 0.31
ajenti.plugin.core 0.99
ajenti.plugin.dashboard 0.39
ajenti.plugin.filesystem 0.47
ajenti.plugin.passwd 0.24
ajenti.plugin.plugins 0.47
ajenti.plugin.session-list 0.4
ajenti.plugin.settings 0.30
Then simply remove all these modules:
sudo pip3 uninstall -y aj ajenti-panel ajenti.plugin.ace ajenti.plugin.auth-users ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.filesystem ajenti.plugin.passwd ajenti.plugin.plugins ajenti.plugin.session-list ajenti.plugin.settings
Configuration files¶
If you don’t need it for later, just delete the directory /etc/ajenti/:
sudo rm -rf /etc/ajenti/