How to Install Snipe-IT with Apache on Ubuntu Linux

If you’re looking to manage your IT assets efficiently, setting up Snipe-IT on your Ubuntu server with Apache is an excellent choice. This guide walks you through installing and configuring Snipe-IT, enabling you to track hardware, software, and other assets with ease. Before you begin, ensure your Ubuntu system is up to date and has basic familiarity with terminal commands. You’ll also need administrative (sudo) access to your server.

What You’ll Need

• Ubuntu Linux server (version 20.04 or later recommended)
• Root or sudo access
• Apache web server installed and running
• MySQL or MariaDB database server
• PHP 7.4 or newer with required modules
• Composer PHP dependency manager
• Domain name pointing to your server (optional but recommended)
• SSL certificate for HTTPS (optional but recommended)

Step-by-Step

1. Update Your System

sudo apt update && sudo apt upgrade -y

2. Install Apache Web Server

sudo apt install apache2 -y

3. Install PHP and Required Modules

sudo apt install php php-cli php-mbstring php-xml php-bcmath php-zip php-curl php-mysql libapache2-mod-php -y

4. Install Database Server

sudo apt install mariadb-server -y

5. Secure Your Database Server

sudo mysql_secure_installation

6. Create a Database for Snipe-IT

sudo mysql -u root -p
CREATE DATABASE snipeit;
CREATE USER 'snipeuser'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON snipeit.* TO 'snipeuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

7. Install Composer

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

8. Download Snipe-IT

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

9. Set Permissions

sudo chown -R www-data:www-data /var/www/snipeit
sudo chmod -R 755 /var/www/snipeit

10. Configure Environment File

cd /var/www/snipeit
cp .env.example .env

11. Edit .env File with Your Database Details

sudo nano .env

– Update database name, user, and password accordingly.

12. Install Dependencies with Composer

composer install --no-dev --prefer-dist

13. Generate Application Key

php artisan key:generate

14. Configure Apache Virtual Host

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

– Add configuration similar to:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/snipeit/public
    <Directory /var/www/snipeit/public>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/snipeit_error.log
    CustomLog ${APACHE_LOG_DIR}/snipeit_access.log combined
</VirtualHost>

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

15. Set Up SSL (Optional but Recommended)

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d yourdomain.com

16. Complete the Web Installation

– Visit http://yourdomain.com or http://server-ip in your browser.
– Follow the on-screen instructions to complete setup, including database connection and admin user creation.

Common Mistakes

• Forgetting to set correct permissions on the snipeit directory, which prevents web access.
• Using incorrect database credentials in the .env file, leading to connection failures.
• Not enabling mod_rewrite in Apache, which is essential for clean URLs.
• Skipping SSL configuration, leaving your data vulnerable.
• Failing to run composer install or missing dependencies, causing application errors.

Tips

• Always keep your system and packages updated for security and stability.
• Use strong, unique passwords for your database and admin accounts.
• Back up your database and configuration files regularly.
• Configure HTTPS to secure data transmission, especially if accessing remotely.
• Monitor your server logs for errors or suspicious activity.

Troubleshooting

If you encounter issues during installation or after setup, consider the following steps:

• Check Apache Logs: Review /var/log/apache2/error.log for clues.
• Verify Database Connection: Ensure credentials are correct in .env and that the database server is running.
• Ensure Permissions Are Correct: The web server user (typically www-data) must have access to the snipeit directory.
• Clear Cache: Run php artisan cache:clear and php artisan config:cache from the snipeit directory.
• Check Dependencies: Run composer install again if missing packages or errors appear.
• Firewall Settings: Confirm that port 80 (HTTP) and 443 (HTTPS) are open.

If problems persist, consult the Snipe-IT community forums or official documentation for specific error messages.

Frequently Asked Questions

1. Can I install Snipe-IT without SSL?

Yes, but it’s recommended to use SSL for security, especially if accessing the system over the internet.

2. How do I update Snipe-IT after installation?

Run git pull in the snipeit directory, then composer install and php artisan migrate –force to update the application.

3. What should I do if I forget my admin password?

Use the command php artisan snipe:reset-password in the snipeit directory to reset the admin password.

4. Is it necessary to install additional PHP modules?

Yes, ensure modules like php-xml, php-mbstring, php-zip, and php-curl are installed as they are required by Snipe-IT.

5. How do I secure my Snipe-IT installation?

Use HTTPS, strong passwords, regular backups, and keep your server updated to prevent unauthorized access.

6. Can I run Snipe-IT on a different web server like Nginx?

Yes, but this guide covers Apache. For Nginx, you’ll need to configure server blocks accordingly and ensure PHP-FPM is installed.

Following these steps carefully will help you successfully install and run Snipe-IT on your Ubuntu server with Apache, giving you a robust asset management system tailored to your needs. Remember to keep your system secure and maintain regular backups for best results.

Related

• How to Hide Your Facebook Story from Someone Easily
• How To Hide or Show Files and Icons on Desktop in Windows 10/11
• How to Hide Specific Desktop Icons in Windows 11 Easily