Where to find Mattermost after installing GitLab omnibus?



I installed the Girlab Mattermost bundle…I see gitlab :slight_smile: but where is the mattermost install located?



I read this:

and enabled mattermost in the config. However when I run reconfigure the subdomain for mattermost is active but just points at the gitlab install…Im using Ubuntu 1404


Hi @booksprint, please see the steps in the GitLab Mattermost install guide to setup Mattermost from the GitLab omnibus.

Here’s more details on GitLab Mattermost from GitLab.com


thanks…I read this but one of the tings it doesnt mention is that you should also enable mattermost in the gitlab.rb config…:slight_smile: that worked…

thanks for your help



Sorry for asking a very stupid question: I have modified gitlab.rb to include

external_url 'http://casgitlab.casalelug.ch
mattermost[‘enable’] = true
mattermost_external_url ‘

but I still do not understand how to access mattermost. Which url should I call?


The URL is not a URL on your MAIN host it’s a whole different virtual host with a different DNS name.

If you read the docs twice, you might find that the first time you missed some essentials, and the second time you grabbed on to them. That’s what happened to me…

  1. If your machine has a DNS entry for casgitlab.casalelug.ch, go add a second DNS entry for chat.casalelug.ch, or whatever you want your mattermost to have.
  2. Follow instructions to set it up. Including creating API key.
  3. Because mattermost is a multitenant application you will find that visiting http://chat.casalelug.ch" will request that you now create a Team (until there’s a team, there’s no other feature in Mattermost that you can access).
  4. After you have a team you will see the main mattermost ui.


Has anyone used that Gitlab/Mattermost document and has gotten the system to work without any additional changes that have not been mentioned there? I think I’m incompatible with their documentation :frowning:

I’m probably missing something quite obvious. I have gitlab omnibus running inside of a virtual machine on a Windows Server in a network that I don’t have admin access to.
I wan’t to activate Mattermost.
Following the documentation i put down “http://mattermost.gitlab-srv” as the mattermost_external_url (gitlab itself is reachable at “http://gitlab-srv”).
Now, if I take the documentation at face-value, that should be it (spoiler alert: it isn’t).

I probably need to add the subdomain somewhere but I’m not quite sure how to do that (can I do that on the virtual machine im running or do I have to add that in our networks DNS server?), and where to point it to get this running.


It’s probably NOT that you’re incompatible.

In my case, the difficulty of getting this working comes from me not initially understanding all that is going on:

  1. I am using mattermost as part of a gitlab “omnibus” installation, and understanding what the “omnibus” thing is doing as it updates and manages things (with chef, I believe) leads to some confusion at times.

  2. The mattermost documentation refers to things that don’t exist like some /opt/mattermost/bin/platform executable. The name of the executable (platform) is is a stupid historical accident and like all stupid historical accidents is not worthy of mention anywhere in any documentation, and so it’s a stumbling block for new users who are not even expecting to learn mattermost (they are just gitlab users). In the omnibus repackage of the mattermost binaries, they did a sensible rename to actually name the main mattermost binary to mattermost.

  3. Database schema upgrades have of late proved an extreme source of pain since the mattermost omnibus chef recipes are trying to automate a bunch of (I believe) postgres SQL schema change updates during updates. These are failing routinely on me, between 7.x and 8.x updates. Even fresh installs of Gitlab Omnibus followed by enabling Mattermost in gitlab.rb were not working on a fresh clean VM out of the box for me as recently as June 2016. I may need to retry that clean VM test now that gitlab 8.9.5 CE is released.

  4. Troubleshooting tools provided with the gitlab+mattermost are sorely lacking. Also any notes on how to manually start up mattermost are sorely lacking. When I determine a useful shell hack, I have a pattern of making a shell script for that purpose. I have built up quite a little library of mattermost and gitlab shell scripts that I use to diagnose things when things go pear shaped.

here’s one I recommend to everyone: I have this as /root/gitlab-mattermost
When mattermost is not runnable (because Go panic, a Panic is Go’s uber-shitty and opinionated replacement for exceptions), it helps to run it from your root shell, while impersonating (with sudo -u mattermost) the correct user account so you can see it panic, or so you can run some command like -upgrade_db_30.

cd /opt/gitlab/embedded/service/mattermost
sudo -u mattermost /opt/gitlab/embedded/bin/mattermost -config=/var/opt/gitlab/mattermost/config_alt.json $@

Usage examples:

/root/gitlab-mattermost -version

/root/gitlab-mattermost -help

There, I invoked mattermost and if I got a version output then mattermost’s Go codebase is not in a pissy mood, and feels like running without panicking.
It may be pissy about localization and just dump core when you try to run it, or anything else. If it is, you have to figure out how to fix the gitlab-mattermost binary or its supporting files. When it’s in a mood like that, obvious your gitlab and mattermost integration is NOT working.

Note also that mattermost is pissy about what the current directory is, and that’s why my shell script above forces a current working directory before running the command line command. Instead of saying “hmm, maybe you’re in the wrong directory” when you run the mattermost binary, it’s going to panic with some irrelevant message about english localization files not being found. Nice.


How to enable Mattermost service?
[SOLVED] Gitlab Omnibus 9.3.x installer does not upgrade Mattermost