snipe-it

Docker app from Progeny42's Repository

Overview

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 5.5. Snipe-IT is actively developed and we release quite frequently. (Check out the live demo here.) 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, flavor of Linux, as well as Windows, and we have a Docker image available if that's what you're into.

snipe-it-by-grok

Crowdin Docker Pulls Tests in MySQL All Contributors Discord

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 12.

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.


Table of Contents


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.


Security

[!IMPORTANT] To report a security vulnerability, please email security@snipeitapp.com instead of using the issue tracker.


Upgrading

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


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. :)

Libraries & Modules

We also have a handful of Google Apps scripts to help with various tasks.

Mobile Apps

We're currently working on our own mobile app, but in the meantime, check out these third-party apps that work with Snipe-IT:


Join the Community!


Contributing

Please refrain from submitting issues or pull requests generated by fully-automated tools. Maintainers reserve the right, at their sole discretion, to close such submissions and to block any account responsible for them. Please see our AI Contribution Policy for more information.

Contributions should follow from a human-to-human discussion in the form of an issue for the best chances of being merged into the core project. (Sometimes we might already be working on that feature, sometimes we've decided against )

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

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.

Be sure to check out all of the amazing people that have contributed to Snipe-IT over the years!


Star History

Star History Chart


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.

We also usually make smaller announcements on our social accounts, our Discord, and our blog, so be sure to subscribe to those if you're looking for more granular announcements.

Install snipe-it on Unraid in a few clicks.

Find snipe-it in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for snipe-it Review the template variables and paths Click Install

Download Statistics

27,482,675
Total Downloads
352,680
This Month
325,553
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
snipe/snipe-it
Last Updated2026-06-29
First Seen2020-09-05

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Privileged
false

Template configuration

MySQL Database NameVariable

The name of your Snipe-IT database.

Target
MYSQL_DATABASE
MySQL UsernameVariable

The MySQL username you set up to access the database.

Target
MYSQL_USER
MySQL PasswordVariable

Your database password for the userd

Target
MYSQL_PASSWORD
MySQL Database HostVariable

The host for your database

Target
MYSQL_PORT_3306_TCP_ADDR
MySQL Database PortVariable

Port number of your MySQL Database.

Target
MYSQL_PORT_3306_TCP_PORT
Default
3306
SMTP AddressVariable

Specify the hostname for your outgoing mail server. Keep in mind that this server must be accessible from the server you're running Snipe-IT on.

Target
MAIL_PORT_587_TCP_ADDR
SMTP PortVariable

Set the port number that your mail server expects to send from

Target
MAIL_PORT_587_TCP_PORT
SMTP From AddressVariable

Specify an email address that is used globally for all e-mails that are sent by your application.

Target
MAIL_ENV_FROM_ADDR
SMTP From NameVariable

Specify the name that should show up in the recipient's inbox when they receive email from your Snipe-IT instance.

Target
MAIL_ENV_FROM_NAME
SMTP EncryptionVariable

Here you may specify the encryption protocol that should be used when the application sends e-mail messages. 'tls' for SMTP-over-SSL 'tcp' for unencrypted

Target
MAIL_ENV_ENCRYPTION
SMTP UsernameVariable

Set the username of the authenticated user you'll be sending email as.

Target
MAIL_ENV_USERNAME
SMTP Email PasswordVariable

Set the password for the authenticated user you'll be sending as.

Target
MAIL_ENV_PASSWORD
App KeyVariable

This is a randomly generated key that your system will use to store encrypted data. Make sure you keep a backup of this value somewhere safe (password manager, etc).

Target
APP_KEY
App URLVariable

This is the url to your application, beginning with http:// or https://

Target
APP_URL
App TimezoneVariable

Set this to be the timezone you wish your Snipe-IT installation to use. This should use a PHP-supported timezone.

Target
APP_TIMEZONE
App LocaleVariable

Set this to reflect the two-letter or 5-letter abbreviation for the language you'd like to use for Snipe-IT. The default language is US English (en)

Target
APP_LOCALE
Default
en
PortPorttcp

Container Port: 80

Target
80
Default
8087
App EnvironmentVariable

This should always be set to production unless you are a developer who is editing code within snipe-IT.

Target
APP_ENV
Default
production
App DebugVariable

Setting this to true will turn on debugging in your Snipe-IT installation. This can be very useful for debugging, but should NEVER be left to true in a production environment.

Target
APP_DEBUG
Default
false
Appdata Config PathPathrw

Container Path: /config

Target
/config
DataPathrw

Container Path: /var/lib/snipeit

Target
/var/lib/snipeit
Default
/mnt/user/appdata/snipeit/data