README.md 4.49 KB
Newer Older
Remi Collet's avatar
Remi Collet committed
1
![GLPI Logo](https://raw.githubusercontent.com/glpi-project/glpi/master/pics/logos/logo-GLPI-250-black.png)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
2

3
[![CircleCI](https://img.shields.io/circleci/project/github/glpi-project/glpi/9.4/bugfixes.svg)](https://circleci.com/gh/glpi-project)
4 5 6 7 8 9
[![Github All Releases](https://img.shields.io/github/downloads/glpi-project/glpi/total.svg)](#download)
[![Twitter Follow](https://img.shields.io/twitter/follow/GLPI_PROJECT.svg?style=social&label=Follow)](https://twitter.com/GLPI_PROJECT)


## About GLPI

Remi Collet's avatar
Remi Collet committed
10
GLPI stands for **Gestionnaire Libre de Parc Informatique** is a Free Asset and IT Management Software package, that provides ITIL Service Desk features, licenses tracking and software auditing.
Alexandre Delaunay's avatar
Alexandre Delaunay committed
11

Remi Collet's avatar
Remi Collet committed
12
GLPI features:
13 14
* Inventory of computers, peripherals, network printers and any associated components through an interface, with inventory tools such as: [FusionInventory](http://fusioninventory.org/) or [OCS Inventory](https://www.ocsinventory-ng.org/fr/)
* Data Center Infrastructure Management (DCIM)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
15 16 17 18 19 20
* Item lifecycle management
* Licenses management (ITIL compliant)
* Management of warranty and financial information (purchase order, warranty and extension, damping)
* Management of contracts, contacts, documents related to inventory items
* Incidents, requests, problems and changes management
* Knowledge base and Frequently-Asked Questions (FAQ)
21
* Asset reservation
Alexandre Delaunay's avatar
Alexandre Delaunay committed
22

Remi Collet's avatar
Remi Collet committed
23
Moreover, GLPI supports many [plugins](http://plugins.glpi-project.org) that provide additional features.
Alexandre Delaunay's avatar
Alexandre Delaunay committed
24 25 26

## License

27 28
![license](https://img.shields.io/github/license/glpi-project/glpi.svg)

Alexandre Delaunay's avatar
Alexandre Delaunay committed
29
It is distributed under the GNU GENERAL PUBLIC LICENSE Version 2 - please consult the file called [COPYING](https://raw.githubusercontent.com/glpi-project/glpi/master/COPYING.txt) for more details.
Alexandre Delaunay's avatar
Alexandre Delaunay committed
30

31 32 33 34 35 36 37 38 39 40 41 42 43
## Some screenshots

**Tickets Timeline**

![Tickets Timeline](pics/screenshots/timeline.png)

**DCIM drag&drop**

![DCIM drag&drop](pics/screenshots/dcim_racks_draganddrop.gif)

**Components**

![Components](pics/screenshots/components.png)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
44 45 46 47

## Prerequisites

* A web server (Apache, Nginx, IIS, etc.)
Anael Mobilia's avatar
Anael Mobilia committed
48
* MariaDB >= 10.0 or MySQL >= 5.6
Cédric Anne's avatar
Cédric Anne committed
49
* PHP 7.0.8 or higher
Alexandre Delaunay's avatar
Alexandre Delaunay committed
50 51 52
* Mandatory PHP extensions:
    - json
    - mbstring
Johan Cwiklinski's avatar
Johan Cwiklinski committed
53
    - iconv
54
    - pdo_mysql
Alexandre Delaunay's avatar
Alexandre Delaunay committed
55
    - session
56 57
    - gd (picture generation)
    - curl (CAS authentication)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
58 59 60 61 62 63 64

* Recommended PHP extensions (to enable optional features)
    - domxml (CAS authentication)
    - imap (mail collector and users authentication)
    - ldap (users authentication)
    - openssl (encrypted communication)

65 66 67 68 69
 * Supported browsers:
    - IE 11+
    - Edge
    - Firefox (including 2 latests ESR version)
    - Chrome
Anael Mobilia's avatar
Anael Mobilia committed
70

71
Please, consider using browsers on editor's supported version
72

Alexandre Delaunay's avatar
Alexandre Delaunay committed
73 74 75 76 77

## Download

See :
* [releases](https://github.com/glpi-project/glpi/releases) for tarball packages.
Remi Collet's avatar
minor  
Remi Collet committed
78
* [Remi's RPM repository](http://rpms.remirepo.net/) for RPM packages (Fedora, RHEL, CentOS)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
79 80 81 82 83 84 85


## Documentation

Here is a [pdf version](https://forge.glpi-project.org/attachments/download/1901/glpidoc-0.85-en-partial.pdf).
We are working on a [markdown version](https://github.com/glpi-project/doc)

86 87
* [Installation](https://readthedocs.org/projects/glpi-install/)
* [Update](https://glpi-install.readthedocs.io/en/latest/update.html)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
88 89 90 91 92


## Additional resources

* [Official website](http://glpi-project.org)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
93
* [Demo](http://demo.glpi-project.org/)
94
* [Translations on transifex service](https://www.transifex.com/glpi/public/)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
95 96 97
* [Issues](https://github.com/glpi-project/glpi/issues)
* [Suggestions](http://suggest.glpi-project.org)
* [Forum](http://forum.glpi-project.org)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
98
* IRC : irc://irc.freenode.org/glpi
Johan Cwiklinski's avatar
Johan Cwiklinski committed
99
* [Development documentation](http://glpi-developer-documentation.readthedocs.io/en/master/)
Alexandre Delaunay's avatar
Alexandre Delaunay committed
100
* [Plugin directory](http://plugins.glpi-project.org)
Johan Cwiklinski's avatar
Johan Cwiklinski committed
101
* [Plugin development documentation](http://glpi-developer-documentation.readthedocs.io/en/master/plugins/index.html)
102 103


Anael Mobilia's avatar
Anael Mobilia committed
104
## Support
105
GLPI is a living software. Improvements are continuously made, new functionalities are being developed, and issues are being fixed.
Anael Mobilia's avatar
Anael Mobilia committed
106 107 108 109

To ease support and development, we need your help when encountering issues.
There is a GLPI version typical lifecycle:
 * A new major version (9.3) is released.
110
 * Minor versions (9.3.x), fixing bugs or issues, are published after several weeks.
Anael Mobilia's avatar
Anael Mobilia committed
111
   Please consider updating to the latest realeased minor version if you encounter some bugs or performance issues.
112
 * Several months after major version realesed, a new major version (9.4) is released
Anael Mobilia's avatar
Anael Mobilia committed
113 114
   Previous major versions become unsupported, please update to the new major version.
   Obviously, we provide support for the migration tools too!