Basic application knowledge

First login

The default username is okmAdmin and its password is admin. Note that username and password are case sensitive.

Managing users

Since OpenKM 3.0, user management is done from the Administration tab. There you can create users, roles and assign roles to users, etc.

There are two important roles called ROLE_ADMIN and ROLE_USER (these roles are case sensitive). All users must have either ROLE_USER or ROLE_ADMIN. This allows them to connect to the OpenKM server. Any user with ROLE_ADMIN will be able to view the whole repository without limits, and have the Administration tab enabled.

Older OpenKM versions use text file based user management. These files are located in the $JBOSS/server/default/conf/props directory, so you need to edit the openkm-users.conf, openkm-roles.conf and openkm-emails.conf files to add or remove a user from the system.

OpenKM authentication

OpenKM can use several authentication systems (Database, LDAP, Active Directory, etc.) but, by default is configured with an embedded database (HSQLDB).

Setting maximum file upload size

By default the maximum file upload size is unlimited. To limit this, make changes to the Application configuration.

Making OpenKM accessible from other computers

By default, Tomcat only listens for connections on localhost. If you want to access OpenKM from other computers modify the file $TOMCAT_HOME/conf/server.xml, adding the address="0.0.0.0" attribute to the Connector if it doesn't already exist.

<Connector address="0.0.0.0" connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>

GNU/Linux

./bin/catalina.sh start

Windows

\bin\catalina.bat start