hschletz/Braintacle

Braintacle is a set of applications for managing hard- and software on a network. Braintacle keeps a semi-automatic inventory of computers, other network-connected devices and installed software, and provides a generic infrastructure for downloading files and executing commands on selected clients, allowing centralized software updates, remote configuration and more. For developers, a PHP API is provided to access the inventory and control the applications.

About Braintacle

Braintacle is a set of applications for managing hard- and software on a network. Braintacle keeps a semi-automatic inventory of computers, other network-connected devices and installed software, and provides a generic infrastructure for downloading files and executing commands on selected clients, allowing centralized software updates, remote configuration and more. For developers, a PHP API is provided to access the inventory and control the applications.

Requirements

• A PostgreSQL or MySQL (or one of its derivates, like MariaDB) database. Support for other database backends may be added in the future.

• Apache httpd with mod_perl and a database-specific DBD module for the main server component.

• A web server with PHP 7.4 or later for the administration console. PHP is also required for most of the command line tools. The following PHP extensions are required:

  • A database-specific PHP extension, see https://docs.laminas.dev/laminas-db/adapter/#creating-an-adapter-using-configuration

  • The "intl" extension

  • The "mbstring" extension

  • The "zip" extension is optional. If present, the package builder can create ZIP archives on the fly.

  • The "gmp" extension is required on 32 bit PHP installations only.

• Composer

• On every client that should be managed through Braintacle, either the OCS Inventory NG agent for Windows/UNIX/Android or FusionInventory Agent must be installed.

Installation

Refer to the INSTALL.md file in the same directory that contains this file.

Further reading

More detailed information is available in the doc/ directory.

---

LICENSES

Braintacle is released under the GNU General Public License v2 or later. You can find the full license in the COPYING file in the same directory that contains this file.

This project contains some third party code:

• A patched version of the OCS inventory NG server components, licensed under the GNU General Public License v2) is included in the server/ directory.

• The file module/Library/data/MacAddress/manuf is taken from the Wireshark project. GPLv2 and copyright information are contained at the top of this file.