Deployment Instructions for DOCX to PDF Converter
Prerequisites
- Docker installed on your system
- Internet connection for downloading base images and dependencies
Deployment Steps
1. Build the Docker Image
docker build -t docx-to-pdf-converter .
2. Run the Container
docker run -p 7860:7860 docx-to-pdf-converter
3. Access the Application
Open your browser and navigate to http://localhost:7860
Key Improvements for Stability
Java Integration Fixes
- Completely removed Java dependencies from the Docker image
- Added comprehensive environment variables to disable Java integration
- Updated LibreOffice configuration to permanently disable Java support
- Enhanced command-line flags to prevent Java initialization
Error Resolution
These changes resolve the following critical errors:
- "javaldx failed!" - Java initialization failure
- "تعذّر إكمال تثبيت المستخدم" (Cannot complete user installation) - User setup issues
- Conversion failures with return code 77 - LibreOffice startup failures
Performance Benefits
- Faster startup times (no Java VM initialization)
- Reduced memory footprint (no Java runtime)
- More reliable conversions (eliminates Java-related crashes)
- Better container compatibility (no Java security restrictions)
Testing the Deployment
Health Check
Visit http://localhost:7860/health to verify:
- LibreOffice availability
- Java disabled status
- Overall application health
Conversion Test
- Visit
http://localhost:7860 - Upload a DOCX file
- Verify successful conversion without Java errors
Troubleshooting
If Java Errors Persist
- Verify Java dependencies are completely removed from Dockerfile
- Check that all environment variables are set correctly
- Ensure LibreOffice configuration disables Java support
If Conversion Still Fails
- Check file permissions in container
- Verify LibreOffice installation
- Review logs for specific error messages
Support
For issues with the converter, please check:
- Application logs via Docker:
docker logs <container_id> - Health check endpoint:
http://localhost:7860/health - Verify all dependencies are properly installed