This is an unofficial guide. Community testing, feedback and improvements are welcome and greatly appreciated.

1. Install the Windows Subsystem for Linux: https://docs.microsoft.com/en-us/windows/wsl/install-win10

2. Install and setup Docker:

   • Install Docker for Windows: https://docs.docker.com/docker-for-windows/
   • Link Windows Subsystem for Linux to Docker for Windows: https://medium.com/@sebagomez/installing-the-docker-client-on-ubuntus-windows-subsystem-for-linux-612b392a44c4.
     • You should end up with the Docker client running on Linux (WSL) sending commands to your Docker Engine daemon installed on Windows.

   Note: MM-9791 introduced using docker-compose to manage containers. To preserve your data on upgrade, execute the following steps.

   First, backup from any existing containers:

   mysqldump -h 127.0.0.1 --column-statistics=0 -u mmuser -p mattermost_test > mm_mysql_backup.sql
   pg_dump -U mmuser -W -d mattermost_test -h 127.0.0.1 > mm_postgres_backup.bak
   

   Then after upgrading and starting the new docker-compose managed containers, restore the data:

   mysql -u mmuser -p -h 127.0.0.1 mattermost_test < mm_mysql_backup.sql
   psql -U mmuser -W -h 127.0.0.1 -f mm_postgres_backup.bak mattermost_test
   

   If you don’t migrate your data, the new, docker-compose-managed containers will start out empty. To remove the old containers – destroying any existing data – use make clean-old-docker.

3. Install docker-compose (using bash)

   sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
   sudo chmod +x /usr/local/bin/docker-compose
   

4. Install Go using bash (modify installation to latest Go version from https://golang.org/dl/):

   sudo apt-get install -y build-essential
   sudo rm -rf /usr/local/go
   wget https://dl.google.com/go/go1.13.3.linux-amd64.tar.gz
   sudo tar -C /usr/local -xzf go1.13.3.linux-amd64.tar.gz
   

5. Set up your Go workspace:

   1. In PowerShell mkdir d:\Projects\go
   2. In bash ln -s "/mnt/d/Projects/go" /home/<Linux User>/go

6. Update your shell’s initialization script (e.g. .bashrc or .zshrc) and add the following:

   export GOPATH=$HOME/go
   export PATH=$PATH:$GOPATH/bin
   export PATH=$PATH:/usr/local/go/bin
   ulimit -n 8096
   

7. Reload your bash configuration to effect the changes above:

   source ~/.bashrc
   

8. Fork Mattermost server on GitHub from https://github.com/mattermost/mattermost-server.

9. Clone the Mattermost source code from your fork:

   git clone https://github.com/YOUR_GITHUB_USERNAME/mattermost-server.git
   

10. Start the server and test your environment:

    cd mattermost-server
    make run-server
    curl http://localhost:8065/api/v4/system/ping
    make stop-server
    

    If successful, the curl step will return a JSON object containing "status":"OK".

    Note: Browsing directly to http://localhost:8065/ will display a 404 Not Found until the web app is configured. See Web App Developer Setup and Mobile App Developer Setup for additional setup.

    The stop-server make target does not stop all the docker containers started by run-server. To stop the running docker containers:

    make stop-docker
    

Troubleshooting: 

1. If you see an error like the input device is not a TTY. If you are using mintty, try prefixing the command with 'winpty'. Reinstall git for windows and make sure you choose Use Windows' default console window instead of Use MinTTY

2. The LDAP docker container is sometimes slow to start. If you see the following message, either increase the wait time in the make file or run make run twice in a row.

   Ldap test user test.one
   starting mattermost-openldap
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   ldap_sasl_bind(SIMPLE): Can't contact LDAP server (-1)
   Makefile:102: recipe for target 'start-docker' failed