ajenti Feature

  • Easy installation : Ajenti 2 can be easy installed with pip and the provided script.

  • Existing configuration : Picks up your current configuration and works on your existing system as-is, without any preparation.

  • Caring : Does not overwrite your config files, options and comments. All changes are non-destructive.

  • Batteries included : Includes lots of plugins for system and software configuration, monitoring and management.

  • Extensible : Ajenti 2 is easily extensible using Python. Plugin development is a quick and pleasant with Ajenti APIs. Write your first plugin.

  • Modern : Pleasant to look at, satisfying to click and accessible anywhere from tablets and mobile.

  • Lightweight : Small memory footprint and CPU usage. Runs on low-end machines, wall plugs, routers and so on.

 

ajenti 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

curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install.sh | sudo bash -s -

Automatic Installation in virtual environment

Caution

Please note that this install method is still under tests. Ajenti starts successfully on the previously mentioned supported operating systems, but all functionalities were not tested. Be kind to report any problem with this install method as issue here : https://github.com/ajenti/ajenti/issues

curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install-venv.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/

keywords: pythonajenti