Base de Conhecimento

Invoice Ninja na VPS: faturas e orçamentos no seu servidor

  • invoice ninja, docker, faturas, vps, orçamentos
  • Usuários acharam útil: 0

Veja como instalar o Invoice Ninja numa VPS com Docker Compose: licença ELv2, APP_KEY nova, configurações de exemplo a trocar, primeiro acesso, backup e atualização.

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

Arte da Eleven Host: janela de terminal com o título: Invoice Ninja na VPS: faturas e orçamentos no seu servidor

Capa da Redação Eleven Host para o guia: Invoice Ninja na VPS: faturas e orçamentos no seu servidor Arte: Eleven Host

Invoice Ninja na VPS é uma forma de emitir faturas e orçamentos a partir de um servidor seu. O projeto se descreve como um aplicativo de faturas, orçamentos, projetos e controle de horas, e a instalação aqui usa Docker Compose.

Aqui você vê o que o Invoice Ninja é, o que a licença diz, como subir o sistema com o repositório de Docker do projeto e como trocar as configurações de exemplo, que não servem para um servidor na internet. Depois, o primeiro acesso, o backup e a atualização. Se você ainda não conhece o servidor VPS, comece por O que é servidor VPS: guia simples para iniciantes. Os exemplos usam o endereço fictício 203.0.113.10.

O que é o Invoice Ninja

A descrição oficial no GitHub do projeto, traduzida, diz: um aplicativo de faturas, orçamentos, projetos e controle de horas, com código-fonte disponível (em inglês, "source-available"), construído com Laravel.

O README afirma que todos os recursos Pro e Enterprise do aplicativo hospedado estão incluídos no código com fonte disponível. Na página de releases do GitHub, a versão v5.13.53 aparece como a última, publicada em 2 de novembro.

Licença: leia antes de instalar

O README diz que o Invoice Ninja é lançado sob a Elastic License, e o arquivo LICENSE do projeto traz o título "Elastic License 2.0 (ELv2)". Ela é uma licença de código com fonte disponível, com limitações de uso.

Uma das limitações da licença é não oferecer o software a terceiros como serviço hospedado ou gerenciado. Aqui o assunto é instalar o Invoice Ninja para o seu próprio uso.

O texto da licença traz outras duas limitações: não mover, alterar, desativar ou contornar a função da chave de licença do software, e não alterar, remover ou esconder avisos de licença, direitos autorais ou outros avisos do titular. Os termos de self-host do projeto dizem ainda que a plataforma não pode ser revendida, integrada ou empacotada com software de terceiros.

Em caso de dúvida sobre uso comercial, consulte um profissional.

Sobre a marca: segundo o README, o projeto oferece uma licença white label de $40 por ano para remover a marca do Invoice Ninja. A documentação de white label explica que a marca some das páginas do cliente e dos PDFs. Os valores e as condições podem mudar, então confira a página do projeto antes de contar com eles.

O que você precisa antes

O guia de instalação manual do projeto lista PHP 8.2 com várias extensões, MySQL 5.7 ou superior (ou MariaDB 10.3 ou superior) e Nginx ou Apache com HTTPS ativo. O arquivo composer.json do projeto aceita PHP 8.2 a 8.5 e usa Laravel 12.

Com Docker, você não instala nada disso à mão. O repositório de Docker do projeto sobe o aplicativo, o Nginx, o MySQL e o Redis em contêineres. Esse repositório também chama a imagem Debian, a usada aqui, de imagem nova, com alguns itens ainda por completar. Vale ler o README do repositório antes de seguir.

Você precisa de um servidor com Docker e Docker Compose já instalados. Para ver outro serviço com Docker nesta mesma lógica, leia NocoDB na VPS: como instalar com Docker.

Está escolhendo um servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Baixar o repositório de Docker

O README do repositório dockerfiles do Invoice Ninja usa a branch debian. Estes são os dois primeiros comandos, na ordem do README:

git clone https://github.com/invoiceninja/dockerfiles.git -b debian

cd dockerfiles/debian

Na pasta debian ficam o docker-compose.yml e o arquivo .env de exemplo. O Compose usa a imagem invoiceninja/invoiceninja-debian para o aplicativo, nginx:alpine como servidor web, mysql:8 como banco e redis:alpine para cache e filas. O Nginx do próprio conjunto escuta na porta 80.

Gerar uma APP_KEY nova

O README manda gerar a chave antes de subir os contêineres, com este comando:

docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --show

Cole a chave inteira no .env, na linha APP_KEY=, mantendo o começo base64: que o comando mostrar. O arquivo de exemplo do repositório já vem com uma APP_KEY preenchida, e essa chave é pública. Troque por uma sua.

Trocar as configurações de exemplo

O .env de exemplo do repositório não serve como está para um servidor na internet. Entre outros valores, ele traz APP_URL=http://localhost:8012, APP_DEBUG=true, TRUSTED_PROXIES='*', a senha do banco ninja e a senha de administrador do banco ninjaAdm1nPassword. Quem lê o repositório conhece esses valores.

O que mudar no .env antes da primeira subida

  • APP_KEY: a chave nova gerada no passo anterior.
  • APP_DEBUG: false.
  • APP_URL: o endereço pelo qual você vai abrir o sistema. No exemplo, http://203.0.113.10, ou o seu domínio quando tiver um.
  • DB_PASSWORD e MYSQL_PASSWORD: a mesma senha nova, no lugar de ninja.
  • DB_ROOT_PASSWORD e MYSQL_ROOT_PASSWORD: a mesma senha nova, no lugar de ninjaAdm1nPassword.
  • IN_USER_EMAIL e IN_PASSWORD: seu e-mail e uma senha forte, no lugar de admin@example.com e changeme!.

Essa lista de trocas é um conselho para quem vai usar o sistema na internet, e não um passo do README. As variáveis DB_PASSWORD e MYSQL_PASSWORD aparecem em pares no arquivo, por isso a lista manda trocar as duas pela mesma senha. O mesmo vale para as duas senhas de administrador do banco.

Um ponto sobre e-mail: no exemplo, o valor MAIL_MAILER=log faz o sistema apenas registrar os e-mails em log, sem enviar nada. Para enviar faturas por e-mail, troque esse valor por uma configuração de envio real.

Subir o Invoice Ninja

Com o .env ajustado, suba os contêineres e, como exemplo, confira o estado deles:

docker compose up -d

docker compose ps

O aplicativo espera o MySQL e o Redis ficarem saudáveis antes de iniciar, então a primeira subida pode levar um tempo. Se algo falhar, um exemplo de comando para ver os registros é docker compose logs.

Depois, abra no navegador o endereço que você colocou na APP_URL. A documentação do repositório de Docker não traz HTTPS. Para atender vários sites num mesmo servidor, o guia Nginx Proxy Manager: vários sites numa VPS só mostra uma opção de proxy. Antes de colocar um proxy na frente, leia a documentação dele e confira o campo APP_URL.

Primeiro acesso e remoção do login inicial

O login do primeiro acesso é o que você definiu em IN_USER_EMAIL e IN_PASSWORD. Se você não definir as duas, os valores padrão são admin@example.com e changeme!, o que seria uma porta aberta para quem conhece o repositório.

O README manda definir essas duas variáveis antes da primeira subida e removê-las do .env depois que a subida terminar. A ordem fica assim:

  1. Defina IN_USER_EMAIL e IN_PASSWORD no .env e suba os contêineres.
  2. Entre no sistema com esse e-mail e essa senha.
  3. Abra o .env de novo e apague as duas linhas.
  4. Guarde a senha no seu gerenciador de senhas, porque ela não ficará mais no arquivo.

Backup do Invoice Ninja

O README do repositório de Docker lista o script de backup como item ainda a fazer. Em outras palavras, o projeto não traz uma ferramenta de backup para essa instalação, e o backup fica por sua conta.

Os dados ficam nos volumes nomeados do Compose: mysql_data para o banco, app_storage e app_public para os arquivos do aplicativo. Um conselho: guarde uma cópia do banco e uma cópia desses volumes, junto com o seu .env, em outro lugar fora do servidor.

Um exemplo de comando para tirar uma cópia do banco, com o MySQL em execução e a senha de administrador que você definiu:

docker compose exec -T mysql mysqldump -u root -p ninja > ninja.sql

Esse comando é um exemplo, e não vem do projeto. O nome do banco ninja é o do .env de exemplo; use o que estiver no seu. O comando usa o usuário root do MySQL e a senha de administrador que você definiu, e o arquivo ninja.sql fica na pasta atual.

Atualizar o Invoice Ninja

Segundo o README do repositório de Docker, a atualização é baixar as imagens novas e recriar os contêineres. O README recomenda fazer um backup antes de atualizar:

docker compose pull

docker compose up -d

O arquivo Compose usa a tag latest por padrão, e a variável TAG permite escolher outra. Na página de releases, a versão v5.13.53 aparece com a data de 2 de novembro, e o Docker Hub lista tags de versão como 5.13.53. Para ficar numa versão, defina TAG com a tag que você escolher.

A documentação do projeto avisa também que o Invoice Ninja v5 não é uma atualização direta da v4. Quem vem da v4 deve começar com uma instalação limpa antes de migrar os dados.

Checklist do Invoice Ninja na VPS

  • Licença ELv2 lida, sem oferecer o software a terceiros como serviço gerenciado.
  • Repositório dockerfiles, branch debian, com Docker e Docker Compose no servidor.
  • APP_KEY nova gerada com key:generate --show.
  • APP_DEBUG=false e APP_URL com o endereço que você usa.
  • Senhas do banco e de administrador trocadas.
  • IN_USER_EMAIL e IN_PASSWORD removidos do .env depois da primeira subida.
  • Banco e volumes copiados antes de cada atualização.

Onde instalar

Os passos acima pedem um servidor com o Docker instalado e administrado por você.

Ainda decidindo o plano? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

Perguntas frequentes

O que a licença ELv2 diz sobre oferecer o Invoice Ninja a terceiros?

Uma das limitações da licença ELv2 é não oferecer o software a terceiros como serviço hospedado ou gerenciado. Em caso de dúvida sobre uso comercial, consulte um profissional.

Qual é o login padrão do Invoice Ninja no Docker?

É o que você definir em IN_USER_EMAIL e IN_PASSWORD. Se não definir, os valores são admin@example.com e changeme!. O README manda remover as duas variáveis do .env depois da primeira subida.

O Invoice Ninja tem backup automático?

O repositório de Docker não traz uma ferramenta de backup: o README lista o script de backup como item a fazer, então guarde você mesmo o banco e os volumes.

Posso usar o .env de exemplo como está?

Não num servidor na internet. O arquivo traz APP_DEBUG=true, senhas de exemplo e uma APP_KEY já preenchida. Troque esses valores antes de subir.

Como atualizar o Invoice Ninja?

Faça o backup, rode docker compose pull e depois docker compose up -d, como no README do repositório de Docker.

Esta resposta lhe foi útil?

Artigos Relacionados