RAG/docker/soffice/README.md

soffice-service

Minimal service that provides a REST endpoint to convert .doc files (server-side paths) to .docx using LibreOffice (soffice).

Usage:

• Build: docker-compose build soffice-service
• Start: docker-compose up -d soffice-service
• Health: GET /health
• Convert (server-path): POST /convert with JSON body { "path": "/path/to/file.doc", "delete_original": true }

Notes:

• Ensure soffice (LibreOffice) is available in the container (Dockerfile installs it).
• The endpoint performs atomic replace: the resulting .docx replaces or is created next to the original file, and the original is removed when delete_original is true.
• This service does no auth; in production, restrict access to trusted networks or add auth/proxy.