2016-06-15 21:23:58 -07:00
[](https://travis-ci.org/snipe/snipe-it) [](http://waffle.io/snipe/snipe-it) []() [](https://crowdin.com/project/snipe-it) [](https://gitter.im/snipe/snipe-it?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge) [](https://hub.docker.com/r/snipe/snipe-it/) [](https://twitter.com/snipeyhead) [](https://zenhub.io) [](https://www.codacy.com/app/snipe/snipe-it?utm_source=github.com& utm_medium=referral& utm_content=snipe/snipe-it& utm_campaign=Badge_Grade)
2017-03-31 15:46:42 -07:00
[](#contributors)
2016-03-25 04:03:28 -07:00
2016-06-02 21:16:43 -07:00
## Snipe-IT - Open Source Asset Management System
2016-03-25 04:03:28 -07:00
This is a FOSS project for asset management in IT Operations. Knowing who has which laptop, when it was purchased in order to depreciate it correctly, handling software licenses, etc.
2017-03-11 07:59:45 -08:00
It is built on [Laravel 5.4 ](http://laravel.com ).
2016-03-25 04:03:28 -07:00
2016-06-02 21:16:43 -07:00
Snipe-IT is actively developed and we're [releasing quite frequently ](https://github.com/snipe/snipe-it/releases ). ([Check out the live demo here](https://snipeitapp.com/demo/).)
2016-03-25 04:03:28 -07:00
2016-06-02 21:16:43 -07:00
__This is web-based software__. This means there there is no executable file (aka no .exe files), and it must be run on a web server and accessed through a web browser. It runs on any Mac OSX, flavor of Linux, as well as Windows, and we have a [Docker image ](https://snipe-it.readme.io/docs/docker ) available if that's what you're into.
2016-03-25 04:03:28 -07:00
-----
### Installation
2016-06-02 21:16:43 -07:00
For instructions on installing and configuring Snipe-IT on your server, check out the [installation manual ](https://snipe-it.readme.io/docs ). (Please see the [requirements documentation ](https://snipe-it.readme.io/docs/requirements ) for full requirements.)
2016-03-25 04:03:28 -07:00
2016-06-02 21:16:43 -07:00
If you're having trouble with the installation, please check the [Common Issues ](https://snipe-it.readme.io/docs/common-issues ) and [Getting Help ](https://snipe-it.readme.io/docs/getting-help ) documentation, and search this repository's open *and* closed issues for help.
-----
### User's Manual
2017-03-11 07:59:45 -08:00
For help using Snipe-IT, check out the [user's manual ](https://snipe-it.readme.io/docs/overview ).
2016-03-25 04:03:28 -07:00
-----
### Bug Reports & Feature Requests
2017-03-11 08:01:05 -08:00
Feel free to check out the [GitHub Issues for this project ](https://github.com/snipe/snipe-it/issues ) to open a bug report or see what open issues you can help with. Please search through existing issues (open *and* closed) to see if your question has already been answered before opening a new issue.
2016-03-25 04:03:28 -07:00
2017-03-11 07:59:45 -08:00
**PLEASE see the [Getting Help Guidelines ](https://snipe-it.readme.io/docs/getting-help ) and [Common Issues ](https://snipe-it.readme.io/docs/common-issues ) before opening a ticket, and be sure to complete all of the questions in the Github Issue template to help us to help you as quickly as possible.**
2016-03-25 04:03:28 -07:00
-----
### Upgrading
2016-05-20 01:44:24 -07:00
Please see the [upgrading documentation ](https://snipe-it.readme.io/docs/upgrading ) for instructions on upgrading Snipe-IT.
2016-03-25 04:03:28 -07:00
------
### Announcement List
To be notified of important news (such as new releases, security advisories, etc), [sign up for our list ](http://eepurl.com/XyZKz ). We'll never sell or give away your info, and we'll only email you when it's important.
------
### Translations!
2016-05-20 01:44:24 -07:00
Please see the [translations documentation ](https://snipe-it.readme.io/docs/translations ) for information about available languages and how to add translations to Snipe-IT.
2016-03-25 04:03:28 -07:00
-----
2017-03-11 07:27:22 -08:00
### Contributors
2017-03-11 06:48:49 -08:00
2017-03-11 08:21:37 -08:00
Thanks goes to all of these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)) who have helped Snipe-IT get this far:
2017-03-11 06:48:49 -08:00
<!-- ALL - CONTRIBUTORS - LIST:START - Do not remove or modify this section -->
2017-03-11 08:21:37 -08:00
| [<img src="https://avatars3.githubusercontent.com/u/197404?v=3" width="110px;"/><br /><sub>snipe</sub> ](http://www.snipe.net )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=snipe) 🚇 [📖 ](https://github.com/snipe/snipe-it/commits?author=snipe ) [⚠️ ](https://github.com/snipe/snipe-it/commits?author=snipe ) [🐛 ](https://github.com/snipe/snipe-it/issues?q=author%3Asnipe ) 🎨 👀 | [<img src="https://avatars0.githubusercontent.com/u/36335?v=3" width="110px;"/><br /><sub>Brady Wetherington</sub> ](http://www.uberbrady.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=uberbrady) [📖 ](https://github.com/snipe/snipe-it/commits?author=uberbrady ) 🚇 👀 | [<img src="https://avatars0.githubusercontent.com/u/3803132?v=3" width="110px;"/><br /><sub>Daniel Meltzer</sub> ](https://github.com/dmeltzer )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=dmeltzer) [⚠️ ](https://github.com/snipe/snipe-it/commits?author=dmeltzer ) [📖 ](https://github.com/snipe/snipe-it/commits?author=dmeltzer ) | [<img src="https://avatars0.githubusercontent.com/u/1609106?v=3" width="110px;"/><br /><sub>Michael T</sub> ](http://www.tuckertechonline.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=mtucker6784) | [<img src="https://avatars2.githubusercontent.com/u/3274937?v=3" width="110px;"/><br /><sub>madd15</sub> ](https://github.com/madd15 )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=madd15) 💬 | [<img src="https://avatars2.githubusercontent.com/u/894126?v=3" width="110px;"/><br /><sub>Vincent Sposato</sub> ](https://github.com/vsposato )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=vsposato) | [<img src="https://avatars0.githubusercontent.com/u/1639757?v=3" width="110px;"/><br /><sub>Andrea Bergamasco</sub> ](https://github.com/vjandrea )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=vjandrea) |
2017-03-11 07:14:20 -08:00
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
2017-03-11 07:28:15 -08:00
| [<img src="https://avatars0.githubusercontent.com/u/10640152?v=3" width="110px;"/><br /><sub>Karol</sub> ](https://github.com/kpawelski )< br /> 🌍 [💻 ](https://github.com/snipe/snipe-it/commits?author=kpawelski ) | [<img src="https://avatars3.githubusercontent.com/u/600106?v=3" width="110px;"/><br /><sub>morph027</sub> ](http://blog.morph027.de/ )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=morph027) | [<img src="https://avatars3.githubusercontent.com/u/22935755?v=3" width="110px;"/><br /><sub>fvleminckx</sub> ](https://github.com/fvleminckx )< br /> 🚇 | [<img src="https://avatars2.githubusercontent.com/u/15633547?v=3" width="110px;"/><br /><sub>itsupportcmsukorg</sub> ](https://github.com/itsupportcmsukorg )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=itsupportcmsukorg) [🐛 ](https://github.com/snipe/snipe-it/issues?q=author%3Aitsupportcmsukorg ) | [<img src="https://avatars3.githubusercontent.com/u/12373799?v=3" width="110px;"/><br /><sub>Frank</sub> ](https://override.io )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=base-zero) | [<img src="https://avatars0.githubusercontent.com/u/10137?v=3" width="110px;"/><br /><sub>Deleted user</sub> ](https://github.com/ghost )< br /> 🌍 | [<img src="https://avatars1.githubusercontent.com/u/10802313?v=3" width="110px;"/><br /><sub>tiagom62</sub> ](https://github.com/tiagom62 )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=tiagom62) 🚇 |
2017-03-11 07:29:29 -08:00
| [<img src="https://avatars3.githubusercontent.com/u/2389047?v=3" width="110px;"/><br /><sub>Ryan Stafford</sub> ](https://github.com/rystaf )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=rystaf) | [<img src="https://avatars2.githubusercontent.com/u/10345935?v=3" width="110px;"/><br /><sub>Eammon Hanlon</sub> ](https://github.com/ehanlon )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=ehanlon) | [<img src="https://avatars0.githubusercontent.com/u/441924?v=3" width="110px;"/><br /><sub>zjean</sub> ](https://github.com/zjean )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=zjean) | [<img src="https://avatars0.githubusercontent.com/u/12660103?v=3" width="110px;"/><br /><sub>Matthias Frei</sub> ](http://www.frei.media )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=FREImedia) | [<img src="https://avatars0.githubusercontent.com/u/3767518?v=3" width="110px;"/><br /><sub>opsydev</sub> ](https://github.com/opsydev )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=opsydev) | [<img src="https://avatars1.githubusercontent.com/u/82290?v=3" width="110px;"/><br /><sub>Daniel Dreier</sub> ](http://www.ddreier.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=ddreier) | [<img src="https://avatars0.githubusercontent.com/u/23448?v=3" width="110px;"/><br /><sub>Nikolai Prokoschenko</sub> ](http://rassie.org )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=rassie) |
2017-03-11 07:34:22 -08:00
| [<img src="https://avatars0.githubusercontent.com/u/13452757?v=3" width="110px;"/><br /><sub>Drew</sub> ](https://github.com/YetAnotherCodeMonkey )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=YetAnotherCodeMonkey) | [<img src="https://avatars0.githubusercontent.com/u/1342320?v=3" width="110px;"/><br /><sub>Walter</sub> ](https://github.com/merid14 )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=merid14) | [<img src="https://avatars3.githubusercontent.com/u/11254614?v=3" width="110px;"/><br /><sub>Petr Baloun</sub> ](https://github.com/balous )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=balous) | [<img src="https://avatars0.githubusercontent.com/u/6117660?v=3" width="110px;"/><br /><sub>reidblomquist</sub> ](https://github.com/reidblomquist )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=reidblomquist) | [<img src="https://avatars0.githubusercontent.com/u/539914?v=3" width="110px;"/><br /><sub>Mathieu Kooiman</sub> ](https://github.com/mathieuk )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=mathieuk) | [<img src="https://avatars3.githubusercontent.com/u/6606421?v=3" width="110px;"/><br /><sub>csayre</sub> ](https://github.com/csayre )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=csayre) | [<img src="https://avatars1.githubusercontent.com/u/768488?v=3" width="110px;"/><br /><sub>Adam Dunson</sub> ](https://github.com/adamdunson )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=adamdunson) |
2017-03-11 07:36:12 -08:00
| [<img src="https://avatars0.githubusercontent.com/u/5547470?v=3" width="110px;"/><br /><sub>Hereward</sub> ](https://github.com/thehereward )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=thehereward) | [<img src="https://avatars0.githubusercontent.com/u/5802977?v=3" width="110px;"/><br /><sub>swoopdk</sub> ](https://github.com/swoopdk )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=swoopdk) | [<img src="https://avatars1.githubusercontent.com/u/3470403?v=3" width="110px;"/><br /><sub>Abdullah Alansari</sub> ](https://linkedin.com/in/ahimta )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=Ahimta) | [<img src="https://avatars0.githubusercontent.com/u/796443?v=3" width="110px;"/><br /><sub>Micael Rodrigues</sub> ](https://github.com/MicaelRodrigues )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=MicaelRodrigues) | [<img src="https://avatars0.githubusercontent.com/u/614564?v=3" width="110px;"/><br /><sub>Patrick Gallagher</sub> ](http://macadmincorner.com )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=patgmac) | [<img src="https://avatars3.githubusercontent.com/u/7165922?v=3" width="110px;"/><br /><sub>Miliamber</sub> ](https://github.com/Miliamber )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=Miliamber) | [<img src="https://avatars3.githubusercontent.com/u/861766?v=3" width="110px;"/><br /><sub>hawk554</sub> ](https://github.com/hawk554 )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=hawk554) |
2017-03-11 07:39:32 -08:00
| [<img src="https://avatars1.githubusercontent.com/u/1695622?v=3" width="110px;"/><br /><sub>Justin Kerr</sub> ](http://jbirdkerr.net )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=jbirdkerr) | [<img src="https://avatars3.githubusercontent.com/u/11426176?v=3" width="110px;"/><br /><sub>Ira W. Snyder</sub> ](http://www.irasnyder.com/devel/ )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=irasnyd) | [<img src="https://avatars2.githubusercontent.com/u/2475759?v=3" width="110px;"/><br /><sub>Aladin Alaily</sub> ](https://github.com/aalaily )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=aalaily) | [<img src="https://avatars0.githubusercontent.com/u/10247644?v=3" width="110px;"/><br /><sub>Chase Hansen</sub> ](https://github.com/kobie-chasehansen )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=kobie-chasehansen) 💬 [🐛 ](https://github.com/snipe/snipe-it/issues?q=author%3Akobie-chasehansen ) | [<img src="https://avatars2.githubusercontent.com/u/13545400?v=3" width="110px;"/><br /><sub>IDM Helpdesk</sub> ](https://github.com/IDM-Helpdesk )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=IDM-Helpdesk) | [<img src="https://avatars2.githubusercontent.com/u/614439?v=3" width="110px;"/><br /><sub>Kai</sub> ](http://balticer.de )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=balticer) | [<img src="https://avatars1.githubusercontent.com/u/8762511?v=3" width="110px;"/><br /><sub>Michael Daniels</sub> ](http://www.michaeldaniels.me )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=mdaniels5757) |
2017-03-11 07:42:03 -08:00
| [<img src="https://avatars3.githubusercontent.com/u/1532660?v=3" width="110px;"/><br /><sub>Tom Castleman</sub> ](http://tomcastleman.me )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=tomcastleman) | [<img src="https://avatars3.githubusercontent.com/u/10723243?v=3" width="110px;"/><br /><sub>Daniel Nemanic</sub> ](https://github.com/DanielNemanic )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=DanielNemanic) | [<img src="https://avatars0.githubusercontent.com/u/150648?v=3" width="110px;"/><br /><sub>SouthWolf</sub> ](https://github.com/southwolf )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=southwolf) | [<img src="https://avatars2.githubusercontent.com/u/131616?v=3" width="110px;"/><br /><sub>Ivar Nesje</sub> ](https://github.com/ivarne )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=ivarne) | [<img src="https://avatars1.githubusercontent.com/u/62333?v=3" width="110px;"/><br /><sub>Jérémy Benoist</sub> ](http://www.j0k3r.net )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=j0k3r) | [<img src="https://avatars2.githubusercontent.com/u/724344?v=3" width="110px;"/><br /><sub>Chris Leathley</sub> ](https://github.com/cleathley )< br /> 🚇 | [<img src="https://avatars0.githubusercontent.com/u/972498?v=3" width="110px;"/><br /><sub>splaer</sub> ](https://github.com/splaer )< br /> [🐛](https://github.com/snipe/snipe-it/issues?q=author%3Asplaer) [💻 ](https://github.com/snipe/snipe-it/commits?author=splaer ) |
2017-03-11 07:44:34 -08:00
| [<img src="https://avatars1.githubusercontent.com/u/967362?v=3" width="110px;"/><br /><sub>Joe Ferguson</sub> ](http://www.joeferguson.me )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=svpernova09) | [<img src="https://avatars3.githubusercontent.com/u/6108682?v=3" width="110px;"/><br /><sub>diwanicki</sub> ](https://github.com/diwanicki )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=diwanicki) [📖 ](https://github.com/snipe/snipe-it/commits?author=diwanicki ) | [<img src="https://avatars3.githubusercontent.com/u/2527115?v=3" width="110px;"/><br /><sub>Lee Thoong Ching</sub> ](https://github.com/pakkua80 )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=pakkua80) | [<img src="https://avatars1.githubusercontent.com/u/461491?v=3" width="110px;"/><br /><sub>Marek Šuppa</sub> ](http://shu.io )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=mrshu) | [<img src="https://avatars1.githubusercontent.com/u/8693762?v=3" width="110px;"/><br /><sub>Juan J. Martinez</sub> ](https://github.com/mizar1616 )< br /> 🌍 | [<img src="https://avatars1.githubusercontent.com/u/1458388?v=3" width="110px;"/><br /><sub>R Ryan Dial</sub> ](https://github.com/rrdial )< br /> 🌍 | [<img src="https://avatars2.githubusercontent.com/u/2871745?v=3" width="110px;"/><br /><sub>Andrej Manduch</sub> ](https://github.com/burlito )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=burlito) |
2017-03-11 07:51:32 -08:00
| [<img src="https://avatars0.githubusercontent.com/u/8341172?v=3" width="110px;"/><br /><sub>Jay Richards</sub> ](http://www.cordeos.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=technogenus) | [<img src="https://avatars2.githubusercontent.com/u/7295127?v=3" width="110px;"/><br /><sub>Alexander Innes</sub> ](https://necurity.co.uk )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=leostat) | [<img src="https://avatars2.githubusercontent.com/u/334485?v=3" width="110px;"/><br /><sub>Danny Garcia</sub> ](https://buzzedword.codes )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=buzzedword) | [<img src="https://avatars2.githubusercontent.com/u/366855?v=3" width="110px;"/><br /><sub>archpoint</sub> ](https://github.com/archpoint )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=archpoint) | [<img src="https://avatars1.githubusercontent.com/u/67991?v=3" width="110px;"/><br /><sub>Jake McGraw</sub> ](http://www.jakemcgraw.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=jakemcgraw) | [<img src="https://avatars1.githubusercontent.com/u/1714374?v=3" width="110px;"/><br /><sub>FleischKarussel</sub> ](https://github.com/FleischKarussel )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=FleischKarussel) | [<img src="https://avatars3.githubusercontent.com/u/319644?v=3" width="110px;"/><br /><sub>Dylan Yi</sub> ](https://github.com/feeva )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=feeva) |
2017-03-31 15:46:42 -07:00
| [<img src="https://avatars2.githubusercontent.com/u/857740?v=3" width="110px;"/><br /><sub>Gil Rutkowski</sub> ](http://FlashingCursor.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=flashingcursor) | [<img src="https://avatars3.githubusercontent.com/u/129360?v=3" width="110px;"/><br /><sub>Desmond Morris</sub> ](http://www.desmondmorris.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=desmondmorris) | [<img src="https://avatars2.githubusercontent.com/u/52936?v=3" width="110px;"/><br /><sub>Nick Peelman</sub> ](http://peelman.us )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=peelman) | [<img src="https://avatars0.githubusercontent.com/u/53161?v=3" width="110px;"/><br /><sub>Abraham Vegh</sub> ](https://abrahamvegh.com )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=abrahamvegh) | [<img src="https://avatars0.githubusercontent.com/u/2818680?v=3" width="110px;"/><br /><sub>Mohamed Rashid</sub> ](https://github.com/rashivkp )< br /> [📖](https://github.com/snipe/snipe-it/commits?author=rashivkp) | [<img src="https://avatars3.githubusercontent.com/u/1509456?v=3" width="110px;"/><br /><sub>Kasey</sub> ](http://hinchk.github.io )< br /> [💻](https://github.com/snipe/snipe-it/commits?author=HinchK) |
2017-03-11 06:48:49 -08:00
<!-- ALL - CONTRIBUTORS - LIST:END -->
2017-03-11 06:56:37 -08:00
This project follows the [all-contributors ](https://github.com/kentcdodds/all-contributors ) specification. Contributions of any kind welcome!
2017-03-11 07:32:48 -08:00
-----
### Contributing
Please see the documentation on [contributing and developing for Snipe-IT ](https://snipe-it.readme.io/docs/contributing ).
Please note that this project is released with a [Contributor Code of Conduct ](CODE_OF_CONDUCT.md ). By participating in this project you agree to abide by its terms.
-----
2017-03-11 06:56:37 -08:00
### Security
To report a security vulnerability, please email security@snipeitapp.com instead of using the issue tracker.
