TypeError with official plone/plone-frontend:19.1.0 Docker image - Backend working, frontend failing

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

:white_check_mark: 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

:cross_mark: 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

  1. Created new project directory
  2. Set up docker-compose.yml following official Plone 6 documentation
  3. Started containers with docker compose up -d
  4. Backend initialized successfully with Volto Light Theme
  5. Frontend container started but shows TypeError in logs
  6. 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 down and docker 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.

@WJa there's no plone.volto:default-homepage profile. Use the plone.volto:default profile instead, this should resolve your problem.

@WJa Can you give a link to the instructions you were following? There used to be a plone.volto:default-homepage profile, so probably you were following something that is out of date.

You mentioned "following official Plone 6 documentation" but the Plone docs don't mention plone.volto:default-homepage, so a link would be helpful to clarify where you were looking.

Thank you both for your help!

To David: The deprecated profile plone.volto:default-homepage came from a masterplan I generated using Devin AI, which contained outdated information.
It was NOT from the official Plone documentation!

To Nikolaus: You were absolutely right - the profile no longer exists. I updated to plone.volto:default as you suggested.

Additional finding: Even after fixing the profile, the plone/plone-frontend:19.1.0 image still had a TypeError.
Anyway, I resolved this by using plone/plone-frontend:18, which works perfectly. So for the moment I will use this version.

Once more, thank you both for getting this working!