From OpenCms Wiki
Jump to: navigation, search


Wiki related questions

Can I contribute to this wiki?

Yes you can! Contribution is welcome. Feel free to edit every page :). Just register with username and password and start editing, have fun!

I want to edit a page, but how does the formatting work?

There is a page with editing help: Help:Editing, take a look at it it is quite easy. misto

It is possible to enable code highlighting?

Sure, a module for mediawiki which does this for you is installed. Just add <source lang="java"> in your article and the code will be highlighted.

Searching through this wiki

You can use the search function shipped with mediawiki or you can use google by entering: "site:opencms-wiki.org your search term".

General questions

What is OpenCms?

OpenCms is a professional level open source content management written in Java with Servlets and JSP. It is platform independent and could be run on every operating system where Java is supported. Currently it is developed by Alkacon with support from the OpenCms community. To get more information about OpenCms take a look at the homepage.

What hardware do I need to get OpenCms running?

Take a look at the Hardware requirements page.

What software do I need to get OpenCms running?

Take a look at the Software requirements page.

Is there such a thing as a step-by-step tutorial to create a website from scratch?

Not at the moment, but there is a discussion going on on the mailing list as of today about the possibility of writing it collaboratively.

Technical questions

Why does the default OpenCms url contain /opencms/opencms/?

The first /opencms/ is the folder of your OpenCms installation in the webapps folder of your servlet container (tomcat,jboss,etc.). The second is a servlet mapping to the main OpenCms servlet which handles the requests. You can install OpenCms as root-application of you servlet container to get rid of the first /opencms/. During the installation process you can rename the servlet mapping (for example to cms) to shorten the second /opencms/.Alternatively there is a guide how to get rid of /opencms/opencms/ shipped with the alcacon documentation. See also Removing /opencms/opencms from site url

My OpenCms upgrade fails, what are common pitfalls?

A common pitfall is that your Servlet container(Tomcat,JBoss,etc.) has no write access to the OpenCms installation, check the permission and give the servlet-container write access.

Another pitfall is that the upgrade wizard is not able to open a display, which can be fixed by starting the servlet container with the following java arguments:


How can I create a custom 404 and 500 Error Page?

Your custom error pages have to be called handle404.html, handle500.html etc and must be placed inside the /system/handler/ directory.


You can style the existing one by setting the template property of the folder /system/handler. Change this from the default (which is /system/handler/template/handlertemplate) to your own template jsp. The only requirement to the template jsp is that it must contain a cms:template element="" for head and foot, like this:

<cms:template element="head">
 <!-- The error page content will be inserted after this -->
<cms:template element="foot">
 <!-- End your html markup here -->

Take a look at the default template for further assistance.

Changing error page content

If you want to provide own content for the error page, you do not have to replace the /system/handler/handleNNN.html file, but according to javadoc of CmsJspStatusBean.getPageContent(String) you can set the template-elements property of /system/handler/handleNNN.html to any file, or edit the content of the default /system/handler/contents/contentNNN.html content file.

User Management

What is the difference between webusers and normal users?

The webusers are not allowed to login into the OpenCms workplace. You can use them to create a restricted area on your homepage. There is a howto how to create a restricted area on your homepage: How to create a restricted area on your homepage. Note: Webusers have been removed from OpenCMS 7.0.

I lost the password of the user "Admin", what can I do?

If you have database access you can reset it with the following SQL query:


This sets the "Admin" password to 'admin'. NOTE: Use this at your own risk!

I want to deny the "Users" group access to a certain folder, how?

When you try to change the permission of certain folder to deny the "Users" access to a certain folder you see that this this group is not editable. The trick is to add the "Users" group again to get the possibility to change the groups permission.

Extending the System

How can I create my own login page?

See: Custom Login Page.

Personal tools