XAMPP
Note:
In general, we do not recommend using XAMPP for Snipe-IT, as there is a built-in alias for
/licenses
that you'll have to override, which can be a bit of a pain. We recommend WAMP or IIS instead if you're running on Windows, but we provide these instructions in case WAMP is not an option.
Download Snipe-IT
Download the Snipe-IT project using one of the methods on the Download page. We strongly recommend installing via Git.
Configure your .env
Follow the directions in the configuration section of the normal setup.
Install Xampp
Download XAMPP from the official site.
Install Composer
In order to install required library dependencies, you'll need to install Composer. You can download Composer from the official source here.
After Composer is installed, open a Windows terminal and type composer
to execute commands:
Use the following command from the Snipe-IT project root to install the required dependencies:
composer install --no-dev --prefer-source
Xampp Virtual Host
For the purposes of this example, we will configure the domain snipe-it.local
.
We need to edit httpd-vhosts.conf
that is located in C:\xampp\apache\conf\extra\httpd-vhosts.conf
and add following lines at the end of the file:
# VirtualHost for SNIPE-IT.LOCAL
<VirtualHost snipe-it.local:80>
DocumentRoot "C:\xampp\htdocs\snipe-it\public"
ServerAdmin snipe-it.local
<Directory "C:\xampp\htdocs\snipe-it">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
#
# ScriptAlias: This controls which directories contain server scripts.
# ScriptAliases are essentially the same as Aliases, except that
# documents in the target directory are treated as applications and
# run by the server when requested rather than as documents sent to the
# client. The same rules about trailing "/" apply to ScriptAlias
# directives as to Alias.
#
# We have to use this script alias for Snipe-IT because
# XAMPP has a built-in URL for /licenses.
# See https://github.com/snipe/snipe-it/issues/4031 for more info
ScriptAlias /licenses/ "C:\xampp\htdocs\snipe-it\public"
</VirtualHost>
After this, our apache is listening to snipe-it.local
connections, but we have to configure our hosts file that allows to redirect snipe-it.local
to the localhost that is located in C:\Windows\System32\drivers\etc
.
Edit your hosts file, adding our localhost for snipe-it.local
:
# localhost name resolution is handled within DNS itself.
# 127.0.0.1 localhost
# ::1 localhost
127.0.0.1 snipe-it.local
Remove Built-In Aliases
As we mentioned at the top of the page, XAMPP comes with a "built-in" URL of /licenses
, so in order for the licenses page to load, you'll need to remove that built-in configuration. If you don't perform this next step, you'll get something like this when you click on the licenses section of Snipe-IT.
To remove this built-in XAMPP alias, edit your httpd-xampp.conf
in your XAMPP config and delete lines below:
Start Apache and MySQL
In your XAMPP interface, start Apache and MySQL:
Now when you go to snipe-it.local
in your browser, it should lead you to the setup.
Note: screenshots via Codementor.
Updated over 3 years ago