[](https://microbadger.com/images/linuxserver/snipe-it "Get your own version badge on microbadger.com")
[](https://microbadger.com/images/linuxserver/snipe-it "Get your own version badge on microbadger.com")
[Snipe-it](https://github.com/snipe/snipe-it) makes asset management easy. It was built by people solving real-world IT and asset management problems, and a solid UX has always been a top priority. Straightforward design and bulk actions mean getting things done faster.
## Supported Architectures
Our images support multiple architectures such as `x86-64`, `arm64` and `armhf`. We utilise the docker manifest for multi-platform awareness. More information is available from docker [here](https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list).
Here are some example snippets to help you get started creating a container from this image.
### docker
```
docker create \
--name=snipe-it \
-e PUID=1001 \
-e PGID=1001 \
-e APP_URL=<hostnameorip> \
-e MYSQL_PORT_3306_TCP_ADDR=<mysqlhost> \
-e MYSQL_PORT_3306_TCP_PORT=<mysqlport> \
-e MYSQL_DATABASE=<mysqldatabase> \
-e MYSQL_USER=<mysqlpass> \
-e MYSQL_PASSWORD=changeme \
-p 8080:80 \
-v <pathtosnipe-itdata>:/config \
--restart unless-stopped \
linuxserver/snipe-it
```
### docker-compose
Compatible with docker-compose v2 schemas.
```yaml
version: "3"
services:
mysql:
image: mysql:5
container_name: snipe_mysql
restart: always
volumes:
-<pathtomysqldata>:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=<secretpassword>
- MYSQL_USER=snipe
- MYSQL_PASSWORD=<secretuserpassword>
- MYSQL_DATABASE=snipe
snipeit:
image: linuxserver/snipe-it:latest
container_name: snipe-it
restart: always
depends_on:
- mysql
volumes:
-<pathtodata>:/config
environment:
- APP_URL=<yourapplicationURLIE192.168.10.1:8080>
- MYSQL_PORT_3306_TCP_ADDR=mysql
- MYSQL_PORT_3306_TCP_PORT=3306
- MYSQL_DATABASE=snipe
- MYSQL_USER=snipe
- MYSQL_PASSWORD=<secretuserpassword>
- PGID=1000
- PUID=1000
ports:
- "8080:80"
```
## Parameters
Docker images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
### Ports (`-p`)
| Parameter | Function |
| :----: | --- |
| `80` | Snipe-IT Web UI |
### Environment Variables (`-e`)
| Env | Function |
| :----: | --- |
| `PUID=1001` | for UserID - see below for explanation |
| `PGID=1001` | for GroupID - see below for explanation |
| `APP_URL=<hostname or ip>` | Hostname or IP and port if applicable IE <iporhostname>:8080 |
| `MYSQL_PORT_3306_TCP_ADDR=<mysql host>` | Mysql hostname or IP to use |
| `MYSQL_PORT_3306_TCP_PORT=<mysql port>` | Mysql port to use |
| `MYSQL_DATABASE=<mysql database>` | Mysql database to use |
| `MYSQL_USER=<mysql pass>` | Mysql user to use |
| `MYSQL_PASSWORD=changeme` | Mysql password to use |
### Volume Mappings (`-v`)
| Volume | Function |
| :----: | --- |
| `/config` | Contains your config files and data storage for Snipe-IT |
| `-e MAIL_ENV_FROM_ADDR=` | The email address mail should be replied to and listed when sent|
| `-e MAIL_ENV_FROM_NAME=` | The name listed on email sent from the default account on the system|
| `-e MAIL_ENV_ENCRYPTION=` | Mail encryption to use IE tls |
| `-e MAIL_ENV_USERNAME=` | SMTP server login username|
| `-e MAIL_ENV_PASSWORD=` | SMTP server login password|
## User / Group Identifiers
When using volumes (`-v` flags), permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
In this instance `PUID=1001` and `PGID=1001`, to find yours use `id user` as below:
