How to Install and Configure Snipe-IT Tool on Ubuntu / Debian

Welcome to! In this article, we will explore together How to Install and Configure the Snipe-IT Tool (Asset Management) on Ubuntu or Debian.

What is the Snipe-IT tool?

Snipe-IT is an open-source asset management system specifically designed to track and manage IT assets within an enterprise environment. Here are some key features of Snipe-IT:

  • Asset Management: Track and manage detailed information about assets, including technical specifications and physical location.
  • Organization and Categorization: Organize assets by category, location, and other attributes for easy search and sorting.
  • Asset History Tracking: Record the history of asset changes to monitor movements, maintenance, and other relevant events.
  • Maintenance and Repairs: Schedule regular maintenance and track repair activities to ensure assets operate efficiently.
  • Inventory and Reporting: Generate comprehensive reports on asset status and audit progress.
  • Human Resource Management: Link assets to users, helping track current users and usage history of assets.
  • Flexible Configuration: Customize information fields, categories, and attributes to reflect the organization’s management needs accurately.

Snipe-IT provides a user-friendly, flexible, and scalable interface, making the asset management process straightforward and efficient.


Step by step Install and Config Snipe-IT on Ubuntu/Debian

Step 1 – Update system

Before we begin, run the following command to update the repository for your system:

sudo apt update

Step 2 – Install dependency packages

Execute the following command to install packages and PHP extensions:

sudo apt install -y openssl curl git wget zip php-opcache php-pdo php-bcmath php-calendar php-ctype php-fileinfo php-ftp php-gd php-intl php-json php-ldap php-mbstring php-mysqli php-posix php-readline php-sockets php-bz2 php-tokenizer php-zip php-curl php-iconv php-phar

Next, run the following command to download and install Composer:

sudo curl -sS | php

Move the composer.phar executable to /usr/local/bin/ directory

sudo mv composer.phar /usr/local/bin/composer

Step 3 – Create Database for Snipe-IT tool

First, log to MySQL/MariaDB database:

sudo mysql -uroot -p

Create a new database named snipe_db


Create a database user named snipe_user with the password snipe_PWD

CREATE USER snipe_user@localhost IDENTIFIED BY 'snipe_PWD';

Grant all privileges on the snipe_db database to the snipe_user database user

GRANT ALL ON snipe_db.* to snipe_user@localhost;

Reload and exit database

Flush privileges;


Step 4 – Download the latest version of the Snipe-IT

First, navigate to the /var/www/html directory

cd /var/www/html

Execute the following command to clone the latest version of Snipe-IT and save it under the name snipe-it

sudo git clone snipe-it

Ensure that it has been downloaded under the name snipe-it by using the command ls as shown below:


Step 5 – Config Snipe-IT

Move to the recently downloaded snipe-it directory with the following command:

cd snipe-it

Copy the default configuration from the .env.example file and save it as .env

sudo cp .env.example to .env

Open the configuration file .env using the vim or vi text editor:

sudo vim .env

Edit the lines below:

Note: replace the following information (IP Server, Timezone, Database Name, Database User, and Database Password) with your own details.

  • APP_URL=http://IP-Server_or_Your-domain
  • APP_TIMEZONE=Asia/Ho_Chi_Minh
  • DB_DATABASE=snipe_db
  • DB_USERNAME=snipe_user

After finishing, save and exit the configuration file.

Install Snipe-IT dependencies using Composer. You may receive a warning about not running this command with root privileges on each command. You need to enter Yes and hit Enter to proceed

sudo composer update --no-plugins --no-scripts

sudo composer install --no-dev --prefer-source --no-plugins --no-scripts

Next, run the following command to generate the Laravel APP_KEY value in the .env configuration file that you created earlier:

sudo php artisan key:generate

The configuration of the Snipe-IT tool is relatively complete up to this point. Now, return to the root directory of the webroot /var/www/html and change ownership and access permissions on the snipe-it directory with the following command:

cd ..

sudo chown -R www-data:www-data /var/www/snipe-it

sudo chmod -R 755 /var/www/html/snipe-it

Next, create a virtual host configuration file for the Snipe-IT tool named snipe-it.conf using the following command:

sudo vim /etc/apache2/sites-available/snipe-it.conf

Add new content below:

<VirtualHost *:80>

  #replace localhost with Your-domain if avaiable
  ServerName localhost
  DocumentRoot /var/www/html/snipe-it/public
  <Directory /var/www/html/snipe-it/public>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all

After finishing, save and exit the configuration file.

Next, activate the configuration file you just created and enable the rewrite mode while disabling the default Apache configuration

sudo a2ensite snipe-it.conf

sudo a2enmod rewrite

sudo a2dissite 000-default.conf

Now, reload the Apache service to apply the changes:

sudo systemctl reload apache2

Step 6 – Setup Snipe-IT tool

Finally, access the address http://IP-Server or http://Your-domain to complete the installation of the Snipe-IT tool.

On the initial screen, you will see content similar to the following. If everything is okay, click Next: Create Database Tables to continue.

The database has been created, click Next: Create User to continue:

At this point, fill in your information and then click Next: Save User to continue:

You will see the dashboard of the snipe-IT similar to the screenshot as shown below:


Read more

Leave a Reply

Your email address will not be published. Required fields are marked *