Guia / Instalar por conta própria

Como instalar o Emissor em Planilha no seu computador

Publicado em 13 de outubro de 2026.

O código do Emissor em Planilha é aberto. Se você prefere não assinar a versão hospedada, instale num computador do escritório que fique ligado e acesse pelo navegador de qualquer máquina da rede.

Opção 1: Windows, com o iniciar.bat

1. Instale os pré-requisitos

   O uv (que instala o Python sozinho) e o Node.js LTS, usado só para gerar a página.

2. Baixe o projeto

   No GitHub, use Code, Download ZIP (ou git clone) e descompacte no computador que vai servir o sistema.

3. Dê dois cliques em iniciar.bat

   Deixe a janela aberta. Na primeira vez ele instala o que falta e gera a página (cerca de um minuto); nas outras, só inicia. Se o Windows perguntar, permita o acesso em redes privadas.

4. Abra no navegador

   http://localhost:8000 no próprio computador, ou http://<nome-do-computador>:8000 nos outros. A janela mostra os dois endereços.

Para atualizar, baixe a versão nova e rode o iniciar.bat de novo: ele percebe o que mudou e refaz o necessário. Para iniciar junto com o Windows, coloque um atalho dele na pasta shell:startup.

Opção 2: Docker (Windows, Linux ou macOS)

Com o Docker instalado, na pasta do projeto, rode docker compose up -d. Os dados ficam na pasta data. Para atualizar, baixe a versão nova e rode o mesmo comando.

Primeiro acesso

Na primeira abertura, o sistema pede para criar o administrador. Abrindo no próprio computador onde ele roda, basta preencher. De outra máquina, ele pede também o código de primeiro acesso, que aparece na janela do emissor e no arquivo data/primeiro-acesso.txt. Depois, siga os primeiros passos a partir da configuração inicial.

Backup

Tudo fica na pasta data: banco de dados, certificado criptografado, chave de criptografia, XMLs e PDFs. Copie a pasta inteira com o sistema parado. Guarde a cópia num lugar protegido, porque ela abre o certificado da empresa.

Instalar ou assinar?

Instalado, o sistema é gratuito, mas o computador precisa ficar ligado, e backup e atualizações ficam por sua conta. Na versão hospedada, ele fica num servidor com endereço próprio, acessível de qualquer lugar, com atualizações automáticas.