I'm setting up a new Plone 6 + Volto project with Volto Light Theme. The backend is working perfectly, but the official frontend Docker image is failing with a TypeError on startup.
Environment
- OS: Windows 11 with WSL2 (Ubuntu)
- Docker: Running inside WSL2
- Plone Backend: plone/plone-backend:6.2
- Plone Frontend: plone/plone-frontend:19.1.0
- Database: PostgreSQL 15-alpine via RelStorage
- Theme: kitconcept.voltolighttheme addon
Docker Compose Configuration
services:
backend:
image: plone/plone-backend:6.2
environment:
- SITE=Plone
- TYPE=volto
- DELETE_EXISTING=false
- CORS_ALLOW_ORIGIN=http://localhost:3000,http://127.0.0.1:3000,http://localhost:4000,http://127.0.0.1:4000
- ADDONS=kitconcept.voltolighttheme
- PROFILES=plone.volto:default-homepage kitconcept.voltolighttheme:default
- RELSTORAGE_DSN=dbname='plone' user='plone' host='db' password='geheim'
ports:
- "8080:8080"
depends_on:
- db
frontend:
image: plone/plone-frontend:19.1.0
environment:
- RAZZLE_API_PATH=http://localhost:8080/Plone
- RAZZLE_INTERNAL_API_PATH=http://backend:8080/Plone
ports:
- "3000:3000"
depends_on:
- backend
db:
image: postgres:15-alpine
environment:
- POSTGRES_USER=plone
- POSTGRES_PASSWORD=geheim
- POSTGRES_DB=plone
volumes:
- db-data:/var/lib/postgresql/data
volumes:
db-data:
Backend Status
Working perfectly
- Backend is accessible at http://localhost:8080/Plone
- Volto Light Theme addon installed successfully
- PostgreSQL database connected via RelStorage
- Site created with profiles:
plone.volto:default-homepage kitconcept.voltolighttheme:default - Health check: Starting (new site, normal behavior)
Backend logs show:
INFO:Plone Site Creation:Creating a new Plone site @ Plone
INFO:Plone Site Creation: - Using the volto distribution
INFO:Zope:Ready to handle requests
INFO:waitress:Serving on http://0.0.0.0:8080
Frontend Status
Failing with TypeError
Frontend logs show repeated errors:
TypeError: Cannot read properties of undefined (reading 'includes')
at T (/app/core/packages/volto/build/server.js:1:1160321)
at R (/app/core/packages/volto/build/server.js:1:1160433)
at /app/core/packages/volto/build/server.js:1:1546303
at process.processTicksAndReactions (node:internal/process/task_queues:104:5)
Container status: unhealthy (health check failing)
Frontend not accessible via browser at http://localhost:3000
Steps Taken
- Created new project directory
- Set up docker-compose.yml following official Plone 6 documentation
- Started containers with
docker compose up -d - Backend initialized successfully with Volto Light Theme
- Frontend container started but shows TypeError in logs
- Browser cannot access frontend (connection refused/timeout)
Troubleshooting Attempted
- Verified backend is running and accessible
- Checked CORS configuration (includes all localhost addresses)
- Tried different port configurations
- Rebuilt containers with
docker compose downanddocker compose up -d - Checked that PostgreSQL is healthy and accepting connections
Expected Behavior
Frontend should start successfully and be accessible at http://localhost:3000, connecting to the backend at http://localhost:8080/Plone.
Additional Notes
- This is a fresh project setup, no customizations yet
- Following official Plone 6 Docker documentation
- No custom frontend code or addons yet
- Using official images from Docker Hub
- Searched community forum but found no similar reports of this specific error
Note: This post was created with assistance from Devin AI during development setup. The environment details and error logs were collected automatically during the troubleshooting process.