You must have Alignak Suite installed before using this app :
Alignak-app need at least a functionnal and available alignak-backend to connect with it !
You must have Python 3 installed on your system. Only the Windows installer does not need to install Python 3.
An installer is available in repository of Alignak-app on releases page. It is recommended that you use this installer to run Alignak-app on Windows.
You have nothing else to install if you are using the installer !
IMPORTANT: To keep it free, installer is not signed, so Windows Defender SmartScreen will warn you about that. Just click on “More Informations” and on “Execute anyway” to run installer.
IMPORTANT: This installer is currently only compatible with x64 architecture !
You can also buid your own Windows installer (on develop branch for example), see Alignak-app Installers for more information.
However, you can install the application in the same way as under Linux, but this will require you to keep a window open for Python.
You can install Alignak-app like other python libraries, with
pip3 install alignak_app
The required Python modules are automatically installed, if not present on your system.
Installation (From Sources)¶
Clone and install¶
To install from source, clone repos and install with pip
git clone https://github.com/Alignak-monitoring-contrib/alignak-app cd alignak-app # If you're under Windows, use "pip" instead "pip3" pip3 install .
You need to install Python modules that are listed in
requirements.txt file with pip:
requests pyqt5 configparser future alignak_backend_client python-gettext docopt
If you’ve installed Alignak-app with
pip under Windows, you must link install directory with your
Program Files folder. Otherwise, App won’t start.
Open a command Windows console as admin and type the following line:
mklink /J "%ProgramFiles%\Alignak-app" c:\Users\<USERNAME>\AppData\Roaming\Python\alignak_app
<USERNAME> by your username.
Be sure also that you’ve install Python3 on your device.
For releases, a setup is generated for Windows and is available for download. For the version under development, you have to do it yourself.
Obviously, you must clone the Alignak-app repository, on the develop branch before.
Like that you’ll have the last fixes. Normally, we try to have a branch
develop as stable as possible.
Python and requirements¶
You have to install Python 3.5 in any case.
Then the requirements of Alignak-app . Otherwize, pyinstaller will not have the required .dll for compilation. All is available on Pypi:
# In repository folder pip install -r requirements.txt --user
Once done, you’ll normally have your python modules installed in:
Then install pyinstaller.
pyinstaller is also available on Pypi. So just run the following command:
pip install pyinstaller --user
Normally, pyinstaller.exe command will be available under:
And will be added to your PATH variable. If it is not the case, you can add this folder to your PATH without problem, you will definitely need it for other python libraries.
Inno Setup is a free installer for Windows. It is very powerful and allows to create and customize installers quite easily.
To install Inno Setup, just download the last unicode version on Official download page.
Be sure to choose unicode version !
And simply run it with values as default.
To create your own setup, you’ll find scripts in
bin\win folder of repository.
There is also images, a redistribuable for Windows (needed for old versions of Windows) and 2 script files.
The first one is
Before running it, check the
Normally, you’ll have just to change the repository folder (line 13).
Be sure to put absolute paths !
The others are normally the sames on your device. If pyinstaller does not find the PyQt dll, check these paths.
Then run the .bat. This script will generate an
alignak-app.exe in dist folder. Don’t move it !
After, simply open the Inno Setup file
alignak-app-win-setup.iss. You can change ShortVersion if you want, but normally these digits are same as current develop.
And then, compile the file with
CTRL+F9 or from menu
This will generate an installer inside the
Your installer is ready !
You can then uninstall the python libraries if necessary, your Setup will no longer use them. All the libraries you need are compressed into the executable.