How to Install and Configure Snipe-IT for IT Asset Management using Docker || Installer guru
Deploy Snipe-IT Easily with Docker Compose | Installer Guru
Step 1: Open the GitHub Repository
Visit the official Snipe-IT GitHub repo: https://github.com/grokability/snipe-it
In the left file panel, scroll and click on docker-compose.yml
On the top-right side of the code section, click on the "Copy" icon (two overlapping boxes) to copy the entire code
Step 2: Open VS Code and Create Project Folder
Launch Visual Studio Code.
Connect to your remote server using SSH (as shown).
Navigate to your folder (example: docker/snipeit) from the Explorer panel.
Click on the "New File" icon at the top to create a new file
Name this file as: docker-compose.yml
Step 3: Copy the docker-compose.yml File
On the top-right of the file viewer, click the Copy icon to copy the entire file content.
Step 4: Paste and Save the File
In VS Code, make sure you're inside the folder snipeit
Paste the copied content from GitHub into this file.
Step 5: Copy the .env.docker File from GitHub
Go to the Snipe-IT GitHub repository
click on the file named .env.docker from the file list
click the Copy icon to copy all the environment variables
Step 6: Create .env.docker File in VS Code
Inside your snipeit folder in VS Code, click “New File” and name it: .env.docker
Paste the full content copied from GitHub into this file
Press Ctrl + S or click the save icon to store the file
Step 7: Update Your .env.docker Values
After pasting the .env.docker content, make sure to update the key values as shown:
Mandatory Updates:
APP_URL=http://localhost:8000 → Change it if hosted remotely.
DB_DATABASE=snipeit
DB_USERNAME=snipeit
DB_PASSWORD=changeme1234
MYSQL_ROOT_PASSWORD=changeme1234
Step 8: Generate App Password for Gmail SMTP
To enable email notifications in Snipe-IT using Gmail:
Open your Google account in browser
Select your app name (e.g., snipeit) and click Create.
Copy the generated 16-character app password shown (e.g., zfhe txkw rvro jhic).
Click Done and save this password for use in your .env file under SMTP settings like:
Step 9: Configure SMTP Mail Settings in .env.docker
Scroll to the “Outgoing Mail Server Settings” section in your .env.docker file and update as follows:
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_PASSWORD=zfhetxkwvrrojhic # Your Gmail App Password
MAIL_TLS_VERIFY_PEER=true
MAIL_FROM_NAME='Snipe-IT'
MAIL_REPLYTO_NAME='Snipe-IT'
MAIL_AUTO_EMBED_METHOD='attachment'
These settings enable Snipe-IT to send system emails like password resets, alerts, and notifications via your Gmail account.
Step 10: Final Docker Configuration Check
Before launching Snipe-IT, ensure these final settings are correct in your docker-compose.yml file:
ports: - "8000:80"
env_file:- snipenv.docker
environment:
MYSQL_DATABASE: snipeit
MYSQL_USER: snipeit
MYSQL_PASSWORD: asset@321
MYSQL_ROOT_PASSWORD: asset@321
Step 11: Open Terminal in Project Directory
In Visual Studio Code, right-click on your project folder
Select "Open in Integrated Terminal" from the dropdown menu
Step 12: Run Snipe-IT Using Docker Compose
In the integrated terminal, make sure both docker-compose.yml and snipenv.docker files are listed by running: ls
Then, start your containers with:- docker-compose up -d
Step 13: Verify Container Creation and Health
After running docker-compose up -d, you should see output like this
If everything shows as Created, Healthy, and Started, it means your setup was successful and Snipe-IT is now running in Docker.
You can now access your Snipe-IT app at:- your server IP + :8000
Step 14: Access Setup Wizard in Browser
Open your browser and go to: http://<your-server-ip>:8000
You will see the Snipe-IT Pre-Flight Check screen
Click the blue button
Step 15: Create Your Admin User
Now click the button: “Next: Create User”
Step 16: Fill Admin Details & Save
You're now on the Create Admin User page. Fill in the form as shown:
fill the all detials
Once completed, click the blue button
“Next: Save User”
Final Step: Welcome to the Snipe-IT Dashboard
After saving your user, you’ll be redirected to the Snipe-IT Admin Dashboard.
Here you can now:
Add assets, licenses, accessories, and consumables
Manage users and permissions
View reports and generate audits
Configure advanced settings
You can now enjoy hassle-free IT asset management with Snipe-IT, deployed by #InstallerGuru – Installation Made Easy.