Pular para conteúdo

Windows

Estas instruções são voltadas para quem administra a instância (perfil mais técnico-operacional).

Pré-requisitos (Windows 10/11)

  1. Instale o Docker Desktop:

  2. https://www.docker.com/products/docker-desktop

  3. Ative o WSL 2 quando solicitado.

  4. Reinicie o PC.

Instalação

  1. Baixe o repositório e entre na pasta usando PowerShell ou terminal de sua preferência:
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Inicie o Farinha usando o script do Windows:
.\run.bat

Na primeira execução, o run.bat:

  • cria o arquivo .env automaticamente a partir do .env-sample;
  • pergunta qual será o endereço público do Farinha (em português e inglês). Se você ainda não souber, pressione Enter para deixar em branco e prosseguir; você poderá editar o .env depois;
  • gera uma SECRET_KEY segura;
  • cria um usuário administrador admin com senha aleatória, exibida no console apenas uma vez. Anote a senha antes de fechar a janela.

A chave automática não contém $. Se uma SECRET_KEY manual contiver $, o script avisará que o Docker Compose pode interpretar esse caractere como variável de ambiente e oferecerá gerar uma nova chave segura.

HTTPS e certificados

O Farinha usa o Caddy para servir HTTPS:

  • Com um endereço público configurado, os certificados gratuitos são obtidos e renovados automaticamente.
  • Para usar certificados próprios, coloque fullchain.pem e privkey.pem na pasta certs, na raiz do projeto.
  • Sem endereço público e sem certificados próprios (por exemplo, localhost), o HTTPS é desabilitado automaticamente.

Veja os detalhes em Segurança e HTTPS, incluindo a variável DISABLE_HTTPS e a proteção contra bots (Anubis).

Atualização

  1. Entre na pasta onde o Farinha foi instalado:
cd farinha
  1. Pare, atualize e suba novamente:
.\down.bat
git pull
.\run.bat

Se a sua instância tiver um procedimento interno específico para parar/subir contêineres, siga esse procedimento antes de atualizar o repositório.

Boas práticas

  • Anote a senha do usuário admin exibida na primeira execução; ela não é mostrada novamente.
  • Mantenha DEBUG=False no .env em instalações reais.
  • Faça o backup do banco (db) antes de atualizações e guarde a pasta certs se usar certificados próprios.
  • Prefira atualizar parando e subindo tudo novamente (down + pull + run), em vez de recriar apenas um container.

Problemas comuns

  • "Docker Desktop não está rodando": inicie o Docker Desktop e rode o run.bat novamente.
  • O script para sem subir: verifique se a SECRET_KEY está presente e sem $ no .env.
  • Perdi a senha do usuário admin: crie outro superusuário pelo terminal, dentro do container:
docker compose -f docker-compose.prod.yml exec web python manage.py createsuperuser
  • Só consigo acessar via HTTP: com localhost ou IP o HTTPS é desabilitado; configure um domínio ou certificados próprios. Veja Segurança e HTTPS.
  • O painel interno não abre em /admin/: alguém pode ter alterado ADMIN_PATH no .env. Veja Usuário SuperAdmin.