First sign-in & the desktop

Once MintJams CMS is running, sign in as the admin user and start using the virtual desktop (Webtop).

1. Retrieve the initial password

If you did not set CMS_INITIAL_ADMIN_PASSWORD, a random password for admin is generated on first boot and written to a file inside the repository. Read it with:

docker exec mintjams cat /data/repository/INITIAL_PASSWORD.txt

This assumes you started with -d --name mintjams; adjust the container name for your setup. If you set CMS_INITIAL_ADMIN_PASSWORD yourself, that value is the password.

2. Sign in

  1. Open http://localhost:8080/ in a browser
  2. Enter admin as the username and the initial password
  3. After signing in, the virtual desktop appears

3. Change the password and delete the initial file

For security, change the password promptly after the first sign-in.

  1. Open the Identity Manager app
  2. Select the admin user and change the password
  3. Then delete the initial password file
docker exec mintjams rm /data/repository/INITIAL_PASSWORD.txt

The initial password file contains plaintext. Always delete it after changing the password.

Desktop basics

After signing in, the screen resembles a desktop OS.

  • Top bar — menus, account, and global actions
  • Launching apps — open the apps you need from the menu; each opens as a window
  • Multiple windows — run several apps at once and freely adjust position and size. For example, design in BPMN Modeler while monitoring BPM Console next to it and keeping Tasks open behind
  • Status bar — status display and supporting actions

Saving and restoring your session

If you save your session when signing out, your window layout is restored at the next sign-in, carrying your working desk over as it was.

Personal settings

From the Preferences app, each user can set the theme, wallpaper and desktop layout.

Next steps

  • Detailed how-to for each app is covered in the User Guide (app manuals), published progressively
  • For configuration and access management in operations, see the Operations guide
  • To build your own apps, head to the Developer Guide