Base de Conhecimento

Snipe-IT na VPS: inventário de TI no seu servidor

  • snipe-it, inventário de ti, docker, vps, lgpd
  • Usuários acharam útil: 0

Snipe-IT v8.8.3: licença AGPL-3.0, requisitos oficiais de PHP e banco, instalação com Docker Compose, HTTPS com proxy reverso, backup com APP_KEY e atualização.

Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Snipe-IT na VPS: inventário de TI no seu servidor

Capa da Redação Eleven Host para o tutorial: Snipe-IT na VPS: inventário de TI no seu servidor Arte: Eleven Host

Snipe-IT na VPS é a forma de manter o inventário de TI da empresa no seu próprio servidor, com um sistema de código aberto para controlar equipamentos, licenças e acessórios. Veja os requisitos oficiais, a instalação com Docker, o HTTPS, o backup e a atualização.

Atualizado em 13/11/2026. Em 13/11/2026, a versão estável mais nova é a v8.8.3, publicada em 22/10/2026. Os blocos marcados como exemplo não foram executados: confira cada um no seu servidor antes de usar.

O que é o Snipe-IT e qual é a licença

O Snipe-IT é um sistema de gestão de ativos de TI mantido pela Grokability. Nele se cadastram equipamentos, licenças de software e acessórios, e se registra quem está com cada item. A licença é a AGPL-3.0, e o código é aberto.

O Snipe-IT é código aberto sob a licença AGPL-3.0, e só aceita banco MySQL ou MariaDB. A versão hospedada pelo fornecedor é paga, e os preços são da Grokability.

Entre os recursos listados no README do projeto estão uma API REST em JSON, login e sincronização de usuários com Active Directory ou LDAP, login único por SAML, grupos com permissões por função, várias empresas dentro de uma mesma instalação e backups com um clique ou por cron. O aplicativo móvel oficial está em beta em 13/11/2026.

Para quem serve

São exemplos de uso, sem promessa de resultado: uma empresa que quer saber em que mesa está cada notebook, ou uma escola que empresta equipamentos e registra a devolução. Para entender o que é uma VPS, o guia completo de servidor VPS explica o básico.

Requisitos oficiais

A página de requisitos pede PHP na faixa >=8.2.0 <8.6, e a versão v8.8.3 recomenda o PHP 8.4 ou mais novo. As extensões do PHP listadas são:

  • JSON, OpenSSL, PDO, Mbstring, Tokenizer, cURL e MySQLi;
  • LDAP, PHPZIP, Fileinfo, BCMath, XML, Sodium e Exif;
  • biblioteca GD (2.0 ou mais nova) ou a extensão Imagick (6.3.8 ou mais nova).

O banco é o MySQL 5.7 ou mais novo, ou o MariaDB. A documentação de configuração diz que o Snipe-IT só aceita MySQL e MariaDB, então PostgreSQL e SQLite ficam de fora. Em servidor web, o manual cobre Apache com mod_rewrite ou Nginx com PHP-FPM. O projeto não publica requisito oficial de memória nem de CPU.

Seis faixas de preço de VPS aparecem na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Dois caminhos de instalação

O manual oficial instala o Snipe-IT direto no servidor: baixar o código com git clone, criar o banco e o usuário, copiar o .env.example para .env, rodar o composer install --no-dev --prefer-source, gerar a chave com php artisan key:generate, ajustar as permissões e apontar o servidor web para a pasta public. O composer deve rodar com o usuário dono dos arquivos, nunca como root.

A instalação abaixo usa o caminho com Docker Compose, que a documentação também traz e que já inclui o banco MariaDB. A imagem oficial é a snipe/snipe-it, e imagens de outros repositórios não são responsabilidade do projeto.

Instalação com Docker Compose, na ordem

Primeiro, o Docker com o Compose precisa estar instalado no servidor, seguindo a documentação do próprio Docker. Segundo, crie uma pasta de trabalho e entre nela:

mkdir snipeit

cd snipeit

Terceiro, baixe para essa pasta o docker-compose.yml e o .env.docker do repositório grokability/snipe-it, no GitHub (os dois ficam em raw.githubusercontent.com/grokability/snipe-it/master/), e salve o segundo com o nome .env. A página de Docker da documentação ainda cita o endereço antigo do repositório, que o GitHub redireciona para o atual.

Quarto, abra o .env e preencha os itens marcados como REQUIRED. O arquivo vem com DB_PASSWORD e MYSQL_ROOT_PASSWORD iguais a changeme1234, e as duas senhas precisam ser trocadas antes do primeiro início. Um exemplo, com valores fictícios:

DB_PASSWORD=troque-esta-senha

MYSQL_ROOT_PASSWORD=troque-esta-outra-senha

APP_DEBUG=false

APP_URL=https://inventario.exemplo.com

O APP_URL começa com http:// ou https://, não leva barra no final e não pode ficar vazio. O APP_DEBUG não deve ficar como true em produção. O arquivo também traz o MAIL_HOST=mailhog, que é um valor de exemplo: a documentação diz que o MAIL_FROM_ADDR é obrigatório e que o sistema pode dar erro 500 se ele ficar vazio, então ajuste os campos de e-mail com os dados do seu servidor de envio.

Quinto, a versão. O compose oficial usa snipe/snipe-it:${APP_VERSION:-latest}: sem versão definida, ele puxa a latest, e a documentação manda evitar essa tag. Recomendamos acrescentar ao .env a linha abaixo, que fixa a versão de 13/11/2026. Confira no Docker Hub o nome exato da tag antes de usar:

APP_VERSION=v8.8.3

Sexto, a porta. O compose publica a porta 8000 do servidor na porta 80 do contêiner (APP_PORT, padrão 8000). Como o acesso vai passar por um proxy com HTTPS, recomendamos trocar a linha de ports do serviço app por este, mantendo o recuo do arquivo, que deixa a porta visível só dentro do próprio servidor:

- "127.0.0.1:8000:80"

Sétimo, o .env traz um APP_KEY de exemplo, e o próprio arquivo pede para gerar outro. Com a versão e a porta já definidas, o comando da documentação abaixo mostra uma chave nova na tela, para você colar no APP_KEY do .env (exemplo, a conferir no seu servidor):

docker compose run --rm app php artisan key:generate --show

Por fim, suba os serviços e acompanhe o início:

docker compose up -d

docker compose ps -a

docker compose logs -f

Os dados ficam em dois volumes nomeados, storage e db_data.

Dois cuidados com o Compose

O docker compose restart não relê o .env: depois de mudar o arquivo, rode o docker compose up -d de novo. E o docker compose down -v apaga os volumes, ou seja, os dados, sem pedir confirmação.

Domínio e HTTPS

O endereço do sistema precisa apontar para o IP da VPS antes de emitir o certificado. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente.

A documentação sobre proxy reverso pede duas coisas. A primeira é o cabeçalho X-Forwarded-Proto, que no Nginx é a linha proxy_set_header X-Forwarded-Proto $scheme;. Sem ele, os links saem em http://. A segunda é a variável APP_TRUSTED_PROXIES, com o IP do proxy, que aceita também uma faixa CIDR. Um exemplo de location, para o bloco server do domínio, a conferir no seu servidor:

location / {

proxy_pass http://127.0.0.1:8000;

proxy_set_header Host $host;

proxy_set_header X-Forwarded-Proto $scheme;

}

Para o certificado, uma opção é o Let's Encrypt com o Certbot, como mostra o artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx. Depois de ajustar o APP_TRUSTED_PROXIES no .env, rode o docker compose up -d outra vez, para o aplicativo ler o valor novo.

Primeiro acesso

Com o HTTPS funcionando, abra o endereço no navegador. Pela página de pré-voo da documentação, a tela confere o ambiente, cria as tabelas do banco e pede para criar o primeiro usuário. Recomendamos criar esse usuário logo, antes de divulgar o endereço, e usar uma senha forte.

Atualização

O projeto está ativo: o repositório teve atividade em 12/11/2026, e as versões v8.8.0, v8.8.1, v8.8.2 e v8.8.3 saíram entre 30/09 e 22/10/2026. A v8.8.2 respondeu à falha PHP2SHELL no PHP e pediu que se atualize o PHP. Em outubro de 2026, o projeto também publicou avisos de segurança no GitHub, e por isso recomendamos manter o sistema atualizado.

A documentação manda fazer cópia do banco e do .env antes de atualizar. Com Docker, a atualização é trocar a versão no APP_VERSION e rodar o docker compose up -d. Um exemplo, depois do backup (na seção seguinte) e com a versão ajustada para a que você escolher:

docker compose pull

docker compose up -d

Backup e a chave do aplicativo

O Snipe-IT tem backup embutido, em Admin, Backups, na interface, ou por linha de comando com php artisan snipeit:backup. O arquivo zip traz o dump SQL do banco, as imagens e os anexos enviados. A restauração é feita pela interface, e ela desconecta os usuários.

O .env e o APP_KEY podem ficar de fora do zip. A documentação do APP_KEY pede para guardar uma cópia em lugar seguro, porque a chave é necessária para decifrar os campos criptografados do banco. Sem ela, esses campos se perdem. Por isso, recomendamos guardar o .env e a chave à parte, fora da VPS. Um exemplo de comando no Compose, a conferir no seu servidor (depois, copie o zip para fora do servidor):

docker compose exec app php artisan snipeit:backup

Confira no seu servidor onde o arquivo é gravado. Cópia que fica só na VPS some junto com ela, e o artigo Backup da VPS: como fazer cópia automática trata desse assunto.

Dados dos funcionários e LGPD

Um inventário de TI que liga equipamentos a pessoas pode guardar nomes e e-mails de funcionários. A LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação, e um software não garante conformidade sozinho. Recomendamos limitar quem acessa o sistema, manter o HTTPS, guardar a cópia de segurança fora do servidor e tratar o assunto com quem cuida do jurídico da empresa.

Escolher o servidor

Sobre onde hospedar um sistema em PHP, há o artigo Onde hospedar sistema PHP: como escolher.

Valores dos seis planos estão na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos

Perguntas frequentes

O Snipe-IT é gratuito?

O código é aberto, sob a licença AGPL-3.0, e pode ser instalado no seu servidor. A Grokability também oferece uma versão hospedada paga, com preços que são dela.

Qual banco de dados o Snipe-IT usa?

Só MySQL ou MariaDB. O compose oficial traz o MariaDB.

Qual versão do PHP é preciso?

A faixa oficial é >=8.2.0 <8.6, com o PHP 8.4 ou mais novo recomendado.

O backup embutido guarda o APP_KEY?

Não dá para contar com isso. Guarde o .env e o APP_KEY à parte, porque sem a chave os campos criptografados se perdem.

O aplicativo móvel oficial está pronto?

Não: em 13/11/2026, o README o descreve como beta.

Esta resposta lhe foi útil?

Artigos Relacionados