guilhermebigois/postgres4protheus repository overview

⁠

⁠PostgreSQL for TOTVS Protheus

A Dockerized PostgreSQL database configured for use with the TOTVS Protheus ERP.

Docker Hub⁠ · Issues and improvements⁠

⁠ ⁠ ⁠ ⁠ ⁠

⁠About

This image is built from the official PostgreSQL Docker image⁠ and follows the database settings required by TOTVS Protheus. The initialization scripts create a Protheus database with:

• WIN1252 encoding
• C collation
• C character type

These settings are based on the TOTVS documentation for supported databases⁠.

⁠Purpose

Setting up a Protheus development environment can be difficult for developers who are starting with ADVPL or learning how the ERP runs on Linux and Docker. This project provides a reproducible PostgreSQL container so that the database layer can be started with fewer manual setup steps.

⁠Prerequisites

• Docker with Docker Compose
• The system requirements required by your Docker installation

If Docker is not installed yet, refer to the official Docker installation documentation⁠.

⁠Running locally

Clone the repository and start the database:

git clone https://github.com/bigois/postgres4protheus.git
cd postgres4protheus
docker compose up -d

The container exposes PostgreSQL on port 5432.

To follow the startup logs:

docker compose logs -f postgres

To stop the container:

docker compose down

⁠Configuration

The Compose file defines the PostgreSQL password and the values used to create the Protheus database. Review and replace these values before using the container outside a local study environment:

The initialization script applies the Protheus values to init.sql before PostgreSQL starts for the first time.

⁠Links

• Docker Hub image⁠
• TOTVS database documentation⁠
• Report an issue⁠

⁠License

This project is licensed under the MIT License⁠.