Invoice Ninja na VPS: faturas e orçamentos no seu servidor
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

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.comechangeme!.
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:
- Defina
IN_USER_EMAILeIN_PASSWORDno.enve suba os contêineres. - Entre no sistema com esse e-mail e essa senha.
- Abra o
.envde novo e apague as duas linhas. - 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_KEYnova gerada comkey:generate --show.APP_DEBUG=falseeAPP_URLcom o endereço que você usa.- Senhas do banco e de administrador trocadas.
IN_USER_EMAILeIN_PASSWORDremovidos do.envdepois 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.