Skip to main content
This page takes you from an installation without the CRM to a first company with a note and a task. The first part is for administrators. The second part is for everyone who works in the CRM.

Switch the CRM on

The CRM is an experimental app, so it is off until someone switches it on. Choose one of the two ways: A person only sees the app when a group of theirs holds it. See Who can use it.

Give the app to groups

1

Open the group

Go to Administration → Groups, open a group and choose App access.
2

Choose the role

Set CRM to User for people who work in it, or Admin for people who manage its model, roles and settings.
The app now appears in the app drawer of every member of the group. A person without the app does not see it, and its address answers “not found”.

Open the CRM as the first administrator

The person who first opens the CRM as system administrator becomes CRM admin. Open the app once with that account before you give it to others. Then open CRM > Settings in the system administration and check roles and settings:
  • Add the people who should work with sales data to the role Sales. Add colleagues who only look things up to Readers.
  • Leave Contacts from mail at None until you have decided how mail may create contacts. See Connect your mailbox.
A person without a CRM role sees nothing, even when the app is available to them. Every other role starts empty.

Create your first company and person

1

Create the company

Open Companies in the sidebar, click New, enter the company name and the domain in the dialog New company, and save. The CRM looks up the logo of the domain in the background. See The record page.
2

Create the person

Open People, click New, enter first name, last name and an email address in the dialog New person, and save.
3

Relate them

Open the person, go to Relations and add the company. The person appears on the page of the company, and the company shows its people.
You see the new records at once in their lists, with the main domain and the owner as columns. More about lists, filters and columns is on Companies and people.

Add a note and a task

On the page of the company:
1

Write a note

Open Notes, click New note, write the text and choose who may read it. See Notes.
2

Add a task

Open Tasks, click New task, give it a title, a due date and a colleague. The colleague gets a notice, and on the due day a second one. See CRM tasks.
Both entries appear on the Timeline of the company next to every change. See Timeline.

What to do next

Troubleshooting

Last modified on November 13, 2026