====== Setup up Mattermost with existing Gitlab ======

Based on
  * http://docs.mattermost.com/developer/developer-setup.html#ubuntu
  * http://docs.mattermost.com/install/prod-ubuntu.html
  * https://github.com/mattermost/docs/pull/25/files
  * http://docs.mattermost.com/deployment/sso-gitlab.html

I was trying to set up mattermost with Gitlab I have installed on an Apache2 server in Ubuntu from source. The follow procedure proved to work for me.

===== Install Docker =====

  * Download and install Docker <code>sudo apt-get update
sudo apt-get install wget
wget -qO- https://get.docker.com/ | sh
sudo usermod -aG docker <username>
sudo service docker start
newgrp docker</code>


  *Set up your dockerhost address by editing your ''/etc/hosts'' file to include the following line <code>127.0.0.1 dockerhost</code>

  * Install build essentials <code>apt-get install build-essential</code>

===== Install Go =====

If you installed the Gitlab 8+, you should already have GO installed.

===== Install Node.js ===== 
<code>curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash -
sudo apt-get install -y nodejs</code>

===== Install mysql server 5.6 or above ===== 

<code>sudo apt-get update
sudo apt-get install mysql-server-5.6</code>

After that, create a databased called ''mattermost''

====== Mattermost Server ======

  * Download the latest Mattermost Server by typing: <code>wget https://releases.mattermost.com/2.2.0/mattermost-team-2.2.0-linux-amd64.tar.gz
tar -xvzf mattermost.tar.gz
</code>

  * Create the storage directory for files. <code>sudo mkdir -p /mattermost/data
sudo chown -R username /mattermost</code>

  * Configure Mattermost Server by editing the config.json file at mattermost/config
    * cd ~/mattermost/config
    * Edit the file by typing: ''nano config.json''
    * replace ''DataSource": "mmuser:mostest@tcp(dockerhost:3306)/mattermost?charset=utf8mb4,utf8'' with your own mysql database name and password

  * Test the Mattermost Server <code>cd ~/mattermost/bin
./platform</code> You should see a console log like <code>Server is listening on :8065</code> if it runs correctly.
  * Stop the server for now by pressing ctrl-c
  * Setup Mattermost to use the Upstart daemon which handles supervision of the Mattermost process. <code>sudo nano /etc/init/mattermost.conf</code> Copy the following lines into /etc/init/mattermost.conf <code>start on runlevel [2345]
stop on runlevel [016]
respawn
chdir /home/ubuntu/mattermost
setuid ubuntu
exec bin/platform</code>
  * Test the setup by starting the service using <code>sudo start mattermost</code> Verify the service is running by typing: curl <code>http://127.0.0.1:8065</code> You should see a page titles Mattermost - Signup if running correctly.
===== Setup up the Apache2 server =====
  * Create a config file using <code>sudo nano /etc/apache2/sites-available/mattermost.conf</code>
  * In the file, include the following (note to change your domain name): <code> <VirtualHost *:80>
  ServerName mattermost.xxx.org

  ProxyPreserveHost On
  RewriteEngine     On

  RewriteCond %{REQUEST_URI}  ^/api/v1/websocket      [NC,OR]
  RewriteCond %{HTTP:UPGRADE} ^WebSocket$             [NC,OR]
  RewriteCond %{HTTP:CONNECTION} ^Upgrade$            [NC]
  RewriteRule .* ws://127.0.0.1:8065%{REQUEST_URI}   [P,QSA,L]

  RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME}    !-f
  RewriteRule .* http://127.0.0.1:8065%{REQUEST_URI} [P,QSA,L]

  # Be sure to uncomment the next 2 lines if https is used
  # RequestHeader set X-Forwarded-Proto "https"
  # Header set Strict-Transport-Security "max-age=31536000; includeSubDomains"


  # Prevent apache from sending incorrect 304 status updates
  RequestHeader unset If-Modified-Since
  RequestHeader unset If-None-Match

  <Location /api/v1/websocket>
     Require all granted
     ProxyPassReverse ws://127.0.0.1:8065/api/v1/websocket
     ProxyPassReverseCookieDomain 127.0.0.1 mattermost.xxx.org
  </Location>

  <Location />
     Require all granted
     ProxyPassReverse http://127.0.0.1:8065/
     ProxyPassReverseCookieDomain 127.0.0.1 mattermost.xxx.org
  </Location>
</VirtualHost>
 </code>
  * Start the service by using <code>
sudo a2enmod proxy
sudo a2enmod proxy_balancer
sudo a2enmod proxy_http
sudo a2enmod mod_proxy_wstunnel
sudo a2enmod headers
sudo a2ensite mattermost
sudo service apache2 reload
</code>

Then you can point to mattermost in your web browser.
===== Using Gitlab as Single-Sign-On  =====
Follow the instruction here: http://docs.mattermost.com/deployment/sso-gitlab.html

{{tag>}}

~~LINKBACK~~
~~DISCUSSION~~