snipe / snipe-it

A free open source IT asset/license management system

Snipe-IT - Open Source Asset Management System

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.

It is built on Laravel 8.

Snipe-IT is actively developed and we release quite frequently. (Check out the live demo here.)

Tip

This is web-based software. This means 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, any flavor of Linux, as well as Windows, and we have a Docker image available if that's what you're into.

---

Installation

For instructions on installing and configuring Snipe-IT on your server, check out the installation manual. (Please see the requirements documentation for full requirements.)

If you're having trouble with the installation, please check the Common Issues and Getting Help documentation, and search this repository's open and closed issues for help.

---

User's Manual

For help using Snipe-IT, check out the user's manual.

---

Bug Reports & Feature Requests

Feel free to check out the GitHub Issues for this project 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.

Important

PLEASE see the Getting Help Guidelines and 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.

---

Upgrading

Please see the upgrading documentation for instructions on upgrading Snipe-IT.

---

Announcement List

To be notified of important news (such as new releases, security advisories, etc), sign up for our list. We'll never sell or give away your info, and we'll only email you when it's important.

---

Translations!

Please see the translations documentation for information about available languages and how to add translations to Snipe-IT.

---

Libraries, Modules & Related Projects

Since the release of the JSON REST API, several third-party developers have been developing modules and libraries to work with Snipe-IT.

Note

As these were created by third-parties, Snipe-IT cannot provide support for these project, and you should contact the developers directly if you need assistance. Additionally, Snipe-IT makes no guarantees as to the reliability, accuracy or maintainability of these libraries. Use at your own risk. :)

• Python Module by @jbloomer
• SnipeSharp - .NET module in C# by @barrycarey
• InQRy -unmaintained- by @Microsoft
• SnipeitPS by @snazy2000 - Powershell API Wrapper for Snipe-it
• jamf2snipe - Python script to sync assets between a JAMFPro instance and a Snipe-IT instance
• jamf-snipe-rename - Python script to rename computers in Jamf from Snipe-IT
• Marksman - A Windows agent for Snipe-IT
• Snipe-IT plugin for Jira Service Desk
• Python 3 CSV importer - allows importing assets into Snipe-IT based on Item Name rather than Asset Tag.
• Snipe-IT Kubernetes Helm Chart - For more information, click here.
• Snipe-IT Bulk Edit - Google Script files to use Google Sheets as a bulk checkout/checkin/edit tool for Snipe-it.
• MosyleSnipeSync by @Karpadiem - Python script to synchronize information between Mosyle and Snipe-IT
• WWW::SnipeIT by @SEDC - perl module for accessing the API
• UniFi to Snipe-IT by @karpadiem - Python script that synchronizes UniFi devices with Snipe-IT.
• Kandji2Snipe by @briangoldstein - Python script that synchronizes Kandji with Snipe-IT.
• SnipeAgent by @ReticentRobot - Windows agent for Snipe-IT

---

Contributing

Please see the documentation on contributing and developing for Snipe-IT.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

The ERD is available online here.

Here is a list of the wonderful people that have contributed to the Snipe-IT.

---

Security

Important

To report a security vulnerability, please email [email protected] instead of using the issue tracker.

snipe-it's Issues

Search box isn't hooked up to anything

Add postcode to locations

Add a field for postal/zip codes

Fix depreciation report with new licenses structure

Figure out how to handle multi-seat licenses

A few different ways I could handle this here, need to spend some time thinking about the best way.

Import functions for users, assets, models, etc

Nice to have, not critical for MVP.

Integrate barcode generation

Want to back this issue? Post a bounty on it! We accept bounties via Bountysource.

incorrect command chown in README

chown -R 755 app/storage ; incorrect

its to be corrected to

chmod -R 755 app/storage

When the number of seats is edited, handle that smartly

Will need to check that assigned users aren't orphaned, that the existing checked out users don't get overwritten, etc.

Add CSV export for reports

Fix checkout for licenses

View is looking for license info, but we're passing a seat ID now

Fix depreciation math

in /app/models/Asset.php - it is made of fail right now. It mostly sorta works, but it's janky as hell.

LDAP authentication

Let somebody else handle password hashing and storage.

Might not be feasible with Sentry, I'm not familiar enough with it to know how flexible it is. Rudimentary research shows others have forked it to add support for LDAP with mixed results.

phpipam uses adLDAP with great success (was the easiest AD integration I have ever experienced with a php app).

Awesome work so far! Let me dig in a little deeper and I hope to contribute and not just gripe about complicated stuff!

This might be another option.

Merge licenses table into assets table

It seemed like a good idea to have them separate before, but now I'm just not so sure. I think maybe adding a boolean 'license' field in the assets table to signify that it's not a piece of physical equipment might be better.

Add location to users, propagate those to assets

Location of the asset matters for tax purposes, so a location needs to be associated with each user/asset.

Calendar view(s) for asset check out/in, due date, etc. [$20]

Definitely not a priority, but some people think in terms of dates better when looking at a calendar-ish view.

---

Did you help close this issue? Go claim the $20 bounty on Bountysource.

Needs sexy dashboard summary

Right now, the dashboard just points to the assets index. Would like a nice overview of assets, things coming due, etc.

Disallow models/depreciations/categories to be deleted if they have assets associated

Right now, you can create orphaned assets, etc. Need to error check that and prevent that from happening.

Fix depreciation on model vs asset

Right now, depreciation shows up in an asset edit form, but isn't actually saved anywhere. It's saved in the Asset Model view, but not on the individual asset level. If I'm going to leave it only at the model level, I should remove it from the asset form to avoid confusion, as it's just BAS right now. (Broke As Shit.)

Add autocomplete to the search box

With a small number of assets it may not be necessary as the assets/models are interactively shown as you type. However, it may be useful for larger data sets.

Support multiple companies [$500 awarded]

This is a fringe case, but it just so happens to apply in my case. My IT team services two sister companies within a parent holding company. Adding this as an enhancement, but unless I hear from other folks who really want this, it's low priority for now.

---

The $500 bounty on this issue has been claimed at Bountysource.

Update asset index/view blade to reflect new status

Improve UI of category display to show nesting

Child assets linked to parent assets (HDD, replacement parts, etc) [$100]

To keep a running record of maintenance on machines, etc

---

Did you help close this issue? Go claim the $100 bounty on Bountysource.

Settings edit

Make the Edit Profile page look less assy

Add notion of lost, stolen, out for deployment, RTD, etc

Some sort of status field for when assets are not deployed or deployable. I'm thinking a status field. When something gets marked as out for maintenance, etc, it gets automatically un-assigned from the user it was assigned to.

Option to mark assets as requestable.

A user wouldn't request a specific laptop that was already checked out to a standard user as their normal laptop, but they may want to request a test device, etc. Should probability have some way of marking which ones can be reserved.

Tighten up checkin/checkout UX

It's mad janky, yo.

Add "clone" option in edit screen for assets

Seed database with models, manufacturers, categories, etc.

A user (non-admin) should be able to request an asset [$15]

They will have to be registered and logged in, but they can then reserve assets like set devices, etc.

---

Did you help close this issue? Go claim the $15 bounty on Bountysource.

Add category back to Models blade/controller

Not sure how it fell off.

Make the report columns sortable

Currently it's unsorted, make the columns sortable.

Confirmation screens on delete

Build-out ACLs to set who can view which sections (reports, etc)

Handle errors more sanely when nothing in the DB

Depreciations isn't seeded to start with (which should be fixed) but it shouldn't blow up even if there are none.

New button weirdly placed on my iPad (3rd gen)

See attached

Show number of assets for each asset model in listing page

Column sorting on table displays

Add asset_type to Asset controller

New field added to the asset log

Move validation out of the controllers and into the models where it belongs

Add reports - depreciation, people with no assets, etc

Fix miscount on assets in user view

This only counts assets now, not licenses, since I changed the way licenses work

XSS Issues

I found 3 area with XSS.

1. Create an Model with a name of <script>alert('a')</script>
   1a. Click Delete the alert pops up twice
   1b. Add an asset and click on the models drop down the alert shows up
2. Create an Asset with a name of <script>alert(1)</script>
   2a. Click Delete, the alert shows up twice

Add warrantee field to assets/models

Ability for admin to check out an asset to a user

Fix tables on mobile

Fields are hidden but you can't scroll over to them.

Implement settings

Fix delete-check on licenses

Previously would check the assigned_to field, but that field no longer exists because of the new license join table

When you soft-delete a user, should free up all associated resources