Containers#

Using containers is the easiest way to try out and deploy Plone 6.

The community provides official images that could be used for standalone Plone installations. These images support a variety of installation options. You can choose from Classic UI or the new frontend, or specialized databases using ZEO or a relational database.

Getting started#

Note

Although there are many container engine tools for developing, managing, and running containers, we will use Docker in this documentation.

System requirements#

Todo

Add system requirements

Install Docker#

Install Docker for your operating system.

Docker Desktop includes all Docker tools. Both macOS and Windows use Docker Desktop. On some Linux distributions a beta version of Docker Desktop is available. If Docker Desktop is not available for your Linux distribution, you may still install Docker Engine and all of its tools. Consult Get Docker for details.

Docker Compose is one of the Docker tools that will be used throughout this documentation.

Start Plone#

First start the Plone Backend, naming it plone6-backend and creating a site with its default configuration, using the following command.

docker run --name plone6-backend -e SITE=Plone -e CORS_ALLOW_ORIGIN='*' -d -p 8080:8080 plone/plone-backend:6.0

Now start the Plone Frontend, linking it to the plone6-backend:

docker run --name plone6-frontend --link plone6-backend:backend -e RAZZLE_API_PATH=http://localhost:8080/Plone -e RAZZLE_INTERNAL_API_PATH=http://backend:8080/Plone -d -p 3000:3000 plone/plone-frontend:latest

Access your Plone site#

Point your browser to http://localhost:3000 and you should see the new Plone site.

Note

The default user is admin and the password is admin.

Shutdown and cleanup#

To stop and clean up the containers use the following commands.

docker stop plone6-frontend && docker rm plone6-frontend
docker stop plone6-backend && docker rm plone6-backend

Next steps#

Get to know the Official Images maintained by the Plone community.

Also see some examples of how to use the Official Images to bootstrap your projects.