You can open the websites app from the launchpad:
The websites app is the place where you can add, remove and configure the websites in your OpenCms installation. You configure, e.g., site name, hostnames and encryption modes.
Furthermore, you configure the access to the workplace server, default site and shared folder.
The main view of the websites app provides an overview on the existing websites.
There are two global configuration options that you can set via the websites app. Click on the gear wheel () in the toolbar to open the dialog for global settings.
Global website options
- Workplace server
Here you configure the server url and encryption mode for accessing the workplace. You can configure multiple server urls.As long as there's only one site configured, you can access the workplace via all server urls, independent of the configuration.
- Default site
If for the server url (hostname + protocol, e.g. https://my-site.de) in the HTTP request getting to OpenCms no specific site is configured, the default site is served.For a productive environment, we suggest an empty site returning only error pages, since anyone can map a domain to your server to get the default site served.As long as you do not add a security layer infront of OpenCms.
The shared folder is where you place contents shared between various sites. By default it is "/shared/".You can only select existing folders directly below the root site to prevent misconfigurations.
Via the "Add site" option () in the toolbar, you can add a new site. If you click the option, a dialog appears:
The dialog has several tabs with many settings. Typically, the "Basic setup" options suffice to create a new site from scratch. If you have a site template that you like to copy when creating a new site, the "Create site options are the interesting ones.
Be aware that some inputs will auto-fill or manipulate other fields.
When you click "OK" in the dialog after filling in appropriate values, the following happens:
- The site folder with some essential resources in is created (if not already present before).
- The template property is set at the site's root folder.
- The site is configured in the
opencms-sites.xmlconfiguration file (under
When you use the "Create site options" to copy an existing site (template) as your new site, the complete site structure will be copied.
Each entry in the list of existing sites has a context menu with options for the site:
Context menu options for sites
OpenCms supports SSL-encrypted sites. The encryption is not done by OpenCms, but dependent on where you encrypt, the configuration option must be set accordingly.
Encryption modes for sites
- Manual SSL encryption
The site is served for https:// requests only. This is the correct setting if your servlet container does the SSL encryption. Links to the site (from other sites) are always prefixed with https://.
- Manual SSL encryption with endpoint termination
The site is served for http:// and https:// requests. This is the setting when you do your SSL encryption in a proxy that communicates with the servlet container via http. Links to the site (from other sites) are always prefixed with https://.