How to install Snipe-IT on Ubuntu 16.04 on AWS Free Tier

Today I show you how to install Snipe-IT on Ubuntu 16.04 using Amazon Web Services Free Tier EC2 instance.

After struggling through at least 5 or 6 incomplete “tutorials” on how to install Snipe-IT on Ubuntu 16.04, I gave up and scrapped the official documentation for you, bringing together the most complete Snipe-IT tutorial out there.

I’m going to utilize a Free Tier eligible instance of AWS EC2. If you want to know how to create a Free Tier eligible EC2 Instance on AWS, watch my YouTube video on it!

Alright, without further ado, let’s get to work.

 

Step 1– Install LAMP

First, we need to install LAMP, that is Linux, Apache2, MySQL, and PHP.

Go ahead and install LAMP following my guide.

Make sure to write down your MySQL root credentials while running through the MySQL installation.

Step 2– Updating Ubuntu 16.04 and installing prerequisites

We start with assuming you have a freshly installed Ubuntu Server 16.04 in front of you or you followed the video above and created a fresh Ubuntu 16.04 instance on AWS EC2.

Updates first:

sudo apt-get update
sudo apt-get upgrade -y

 

Then we are going to login with root by typing:

sudo -i

 

Next, we are going to download composer:

curl -sS https://getcomposer.org/installer | php
SnipeIT Ubuntu 16.04
Downloading Composer

 

Then we are going to move composer to another folder:

mv composer.phar /usr/local/bin/composer
cd /var/www/

 

Alright, time to download snipe-it:

git clone https://github.com/snipe/snipe-it snipeit
cd snipeit/

 

Finally we replace .env.example with .env:

cp .env.example .env

More on that later.

 

Step 3– Configuring the MySQL Database

Time to create our MySQL Database:

mysql -u root -p

 

Now you need to run a couple of commands, make sure to use the EXACT commands like in the box below, replace “your username” and “yourpw” with your own username and password:

    mysql> create database snipeit;
    mysql> CREATE USER 'yourusername'@'localhost' IDENTIFIED BY 'yourpw';
    mysql> GRANT ALL PRIVILEGES ON snipeit.* TO 'yourusername'@'localhost';
    mysql> flush privileges;
    mysql> exit
SnipeIT Ubuntu 16.04
Configuring MySQL

Of course, remember your credentials.

 

Step 4– Editing the .env file

Now we are going to edit the .env config file.

nano .env

 

You need to adjust the values according to your server and the database we created earlier. Remember to enter your username and password that you set in step 3.

Don’t worry about the APP_KEY either, we are going to generate that later.

Hit CTRL+O to write and CTRL+X to exit.

 

Step 5– Adjusting permissions

Now we got to adjust a couple of permissions:

chown -R www-data:www-data storage public/uploads
chmod -R 775 storage
chmod -R 755 public/uploads

 

Step 6– Installing PHP dependencies

Installing PHP dependencies:

apt-get install -y git unzip php php-mcrypt php-curl php-mysql php-gd php-ldap php-zip php-mbstring php-xml
apt-get install php7.0-bcmath

 

Step 7– Installing Composer & generating our App Key

Installing Composer, go get yourself a nice cup of coffee as this will take a while.

composer install --no-dev --prefer-source

 

And generating our APP Key:

php artisan key:generate

Type yes when you get asked if you really want to run that command. Copy the Key and save it somewhere. The Key will automatically get pasted into your .env file.

Install snipeit ubuntu 16.04
Creating the API Key

 

Step 8– Editing configuration files and wrapping up

Almost done guys, hold tight.

Now we are going to enable our Virtual Host:

sudo nano /etc/apache2/sites-available/snipeit.example.com.conf

 

And paste the text into the box below:

<VirtualHost *:80>
ServerAdmin webmaster@localhost
<Directory /var/www/snipeit/public>
        Require all granted
        AllowOverride All
   </Directory>
    DocumentRoot /var/www/snipeit/public
    ServerName YOURSERVERIP
   #Redirect permanent / https://snipeit.your-server-fqdn.com/
        ErrorLog /var/log/apache2/snipeIT.error.log
        CustomLog /var/log/apache2/access.log combined
</VirtualHost>

Make sure to replace YOURSERVERIP with, well, your server IP.

Press CTRL+O to save and CTRL+X to exit.

Now we are going to run a couple apache commands:

sudo a2ensite snipeit.example.com.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

 

And we are going to disable the default.conf

sudo a2dissite 000-default.conf
sudo service apache2 restart

 

Change directory

cd /etc/apache2/sites-available

 

And we are going to rename the default.conf to keep it as a backup:

sudo cp 000-default.conf 000-default.confTEMP

 

And finally remove it:

sudo rm 000-default.conf

 

Already and finally wrapping it up with:

sudo phpenmod mcrypt
sudo phpenmod mbstring
sudo a2enmod rewrite
sudo service apache2 restart

 

Step 9– Setup with the Web Browser

Now you are as good as done. Open a Web Browser and enter your server IP. You should end up here:

 

Ignore the File Owner warning, this seems to be a bug and will probably be fixed in an update. Click on Next: Create Database Tables.

You will likely get an error:

 

Don’t panic, just refresh the page by hitting F5

Click on Next: Create User

Finalize everything to your liking, click F5 if you get the error again.

And congratulations, you are now running a powerful, completely free cloud-based instance of the Snipe IT Asset Management Software on your free tier Amazon EC2 instance.

6
Leave a Reply

Tell us what you think!

This site uses Akismet to reduce spam. Learn how your comment data is processed.

  Subscribe  
newest oldest most voted
Notify of
Mahmoud Eid Ahmed
Guest
Mahmoud Eid Ahmed

after go throw with all steps, when try to open url using my public ip „The connection was reset“ i can’t open it , no page appears ? so please advice

Brendan
Guest
Brendan

Actually never mind I figured it out. Small mistake, I didn’t put the full username with @localhost for the database credentials ha

Brendan
Guest
Brendan

Hey ceos3c,
Great guides, love them so far. But currently I’m running into an issue at about step 9. I follow everything precisely with a fresh 16.04 linux install, up to here. But when I attempt to start up the web page with my ip address, instead of sending me to the pre-flight checkoff page, it sends me to the, „Whoops, looks like something went wrong“ page. Any suggestions?

Ron
Guest
Ron

great step y step guide thanks

Herry R
Guest

I appreciate your detailed information here, but want to add some really helpful information on the topic that can be useful to the developers and users.
For Installing Snipe-IT on AWS instance, you do not need to learn all the technical stuffs, you can host PostgreSQL on AWS using one click ready-to-run Snipe-IT AMI (Amazon Machine Image).
To launch this stack on Amazon EC2 in just 3 simple steps explained below:
https://aws.amazon.com/marketplace/pp/B06Y151QS9?ref_=_ptnr_intuz_ami_snipeit
https://cloud.intuz.com/applications/snipeit/aws/how-to-use?utm_source=Bl-cmt&utm_medium=snipe-IT&utm_campaign=snipe-IT-Bl-cmt

%d bloggers like this: