Windows

These instructions are intended for the person who administers the instance, usually a more technical/operational profile.

Prerequisites (Windows 10/11)

1. Install Docker Desktop:

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

3. Enable WSL 2 when prompted.

4. Restart the computer.

Installation

1. Download the repository and enter the folder using PowerShell or your preferred terminal:

git clone https://gitlab.com/yndexa/farinha.git
cd farinha

1. Start Farinha using the Windows script:

.\run.bat

On the first run, run.bat automatically creates the .env file from .env-sample.

The script also asks for the public Farinha URL. If you do not know it yet, press Enter to leave it blank and continue. You can edit .env later.

SECRET_KEY is generated automatically. The automatic key does not contain $.

If a manual SECRET_KEY contains $, the script warns that Docker Compose may interpret this character as an environment variable and offers to generate a new safe key.

Updating

1. Enter the folder where Farinha was installed:

cd farinha

1. Stop, update, and start again:

.\down.bat
git pull
.\run.bat

If your instance has a specific internal procedure to stop/start containers, follow that procedure before updating the repository.