Creating New Teams and Users in Mattermost Chat

Creating a New Team

To create a new team (company), one has to log in as admin first. Got to syspass.uvt.cz and find a proper password under *chat.uvt.cz*. Then proceed as follows:

1. Go to main menu -> create a new team
2. Create new team with a simple one-word name and all in small letters
3. Switch to the new team
4. Delete channel Off-topic if you think it's unnecessary
5. Rename channel Town-square to <team name>:výchozí
6. Go to main menu -> add members to team and add relevant users to the team (only these users will see the team and will become members of the default channel)
7. If you think it's appropriate, create a new private channel called <team name>:kontakty and create a contact list with the following code

## Seznam kontaktů
- Tomáš Kavalek (ředitel) kavalek@webona.cz `777 574 422`

Creating a New User

To create a new user, one has to SSH to chat.uvt.cz. Use syspass.uvt.cz to find the credentials. Then, proceed as follows:

1. Switch to mattermost

   su - mattermost

2. Find file users.txt and open it for editing
3. Comment-out any previous users in the file
4. Put in a new line for each of the new users you want to create. Put login, email, first name, last name, existing team name, and client shortcut on the line in order delimited by spaces or tabs. For clients (not UVT staff), use <first letter of first name><last name> format for login name primarily if the company does not have a different naming convention. In that case try to use the company's login name format (if it doesn't clash with other users already present in mattermost) in order to simplify log ins for those users. The shortcut should be in capital letters, no more than four characters and unique to the team/company the account belongs to. See other existing users for reference.
5. If the email domain from the user's email has not been used in mattermost before (for other users from the same company/team), you have to enable it in the mattermost system console. It's a security limitation. See the next step.
6. If you need to add a new email domain, log in to mattermost as admin (see above in Creating a New Team), go to main menu -> system console -> settings -> users and teams and add the domain to the list under Restrict account creation to specified email domains.
7. Run

   python users.py

   The script should add new users to the DB.
8. As admin, add the newly created users to their appropriate teams. See above on how to do that.
9. The new users will have a default password set which is constant but unknown. Tell the users to use I forgot my password option to set their password to their liking as they log in for the first time