# Getting Started

**URL:** <https://forum.mattermost.com/t/getting-started/11>\
**Category:** Troubleshooting\
**Created:** [June 25, 2015, 4:48pm UTC](https://forum.mattermost.com/t/getting-started/11 "2015-06-25T16:48:51Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [June 25, 2015, 4:48pm UTC](https://forum.mattermost.com/t/getting-started/11/1 "2015-06-25T16:48:51Z")

</div>

Starting a thread for anyone having issues with the Mattermost install instructions in the README.md. We’ll share updates here and field questions.

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [June 27, 2015, 6:57pm UTC](https://forum.mattermost.com/t/getting-started/11/2 "2015-06-27T18:57:59Z")

</div>

I was able to spin up an instance on AWS Beanstalk but I don’t see any options to create a team or even a user. Am I missing something obvious?

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [June 27, 2015, 7:03pm UTC](https://forum.mattermost.com/t/getting-started/11/3 "2015-06-27T19:03:27Z")

</div>

When you enter the domain you mapped into a browser, you should see at least a field to enter your email with a “Sign Up” button.

What are you seeing when you view the domain you mapped in a browser?

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [June 29, 2015, 1:48pm UTC](https://forum.mattermost.com/t/getting-started/11/4 "2015-06-29T13:48:09Z")

</div>

I’m using [subdomain.domain.com](http://subdomain.domain.com) and do see this below the sign in fields:

`Want to create your own team? Sign up now`

But the `Sign up now` link redirects me to [domain.com](http://domain.com).

Is there something that I need to configure?

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [June 29, 2015, 7:32pm UTC](https://forum.mattermost.com/t/getting-started/11/5 "2015-06-29T19:32:11Z")

</div>

Hi @alarm, please let me know if this FAQ might help?

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [June 29, 2015, 7:35pm UTC](https://forum.mattermost.com/t/getting-started/11/6 "2015-06-29T19:35:34Z")

</div>

Which FAQ is that? I followed the readme instructions exactly…

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [June 29, 2015, 8:10pm UTC](https://forum.mattermost.com/t/getting-started/11/7 "2015-06-29T20:10:24Z")

</div>

Sorry about that, here’s the link

[http://discourse.mattermost.org/t/sub-sub-domains-e-g-www-corp-mydomain-com-not-yet-supported/13/1](http://discourse.mattermost.org/t/sub-sub-domains-e-g-www-corp-mydomain-com-not-yet-supported/13/1)

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [June 29, 2015, 8:13pm UTC](https://forum.mattermost.com/t/getting-started/11/8 "2015-06-29T20:13:38Z")

</div>

It requires [http://www.subdomain.domain.tld](http://www.subdomain.domain.tld), so I can’t use [http://subdomain.domain.tld](http://subdomain.domain.tld)? Should I bother registering a domain to test with or do you anticipate having this resolved fairly soon?

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [June 30, 2015, 12:07am UTC](https://forum.mattermost.com/t/getting-started/11/9 "2015-06-30T00:07:04Z")

</div>

You’d actually want to use [http://subdomain.domain.tld](http://subdomain.domain.tld), since [http://www.subdomain.domain.tld](http://www.subdomain.domain.tld) (what we’re calling a sub-sub-domain) isn’t supported. That’s the fix we’re working on.

There’s a second fix which is removing the domain requirement for the Beanstalk deployment, which should ideally appear on master in a week or two. That said, our next major build release isn’t for another 5 weeks or so (two 2-week sprints plus 1 week testing and stabilization).

If you just want to get it running to take a look, it might be worth setting up the domain with the requirements there.

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [June 30, 2015, 12:39am UTC](https://forum.mattermost.com/t/getting-started/11/10 "2015-06-30T00:39:55Z")

</div>

I am actually using [http://subdomain.domain.tld](http://subdomain.domain.tld) on Beanstalk, without www. That is supported, correct?

I think the issue might be how the hosted zone is configured. The hostname I’m using wasn’t created on AWS…

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [July 2, 2015, 2:16am UTC](https://forum.mattermost.com/t/getting-started/11/11 "2015-07-02T02:16:20Z")

</div>

Edited: @alarm, I think we know what’s wrong. You can’t use subdomain.domain.tld as the root domain for the install, it needs to be domain.tld, and then your teams are TEAM\_NAME.domain.tld.

There’s a pull request under review to fix this ([https://github.com/mattermost/platform/pull/105](https://github.com/mattermost/platform/pull/105)), but right now it doesn’t work.

Fastest resolution would be just to use a domain.tld.

---

<div class="post-metadata">

**Author:** ![alarm](https://avatars.discourse-cdn.com/v4/letter/a/2bfe46/32.png) [@alarm](https://forum.mattermost.com/u/alarm)\
**Post date:** [July 2, 2015, 6:24pm UTC](https://forum.mattermost.com/t/getting-started/11/12 "2015-07-02T18:24:05Z")

</div>

Gotcha, I’ll give that a shot and report back!

---

<div class="post-metadata">

**Author:** ![pro](https://avatars.discourse-cdn.com/v4/letter/p/e56c9b/32.png) [@pro](https://forum.mattermost.com/u/pro)\
**Post date:** [July 13, 2015, 4:02pm UTC](https://forum.mattermost.com/t/getting-started/11/13 "2015-07-13T16:02:28Z")

</div>

I’ve successfully installed Mattermost onto my host on digitalocean, but it seems Mattermost only works with ipv6.

$ netstat -anp | grep 8065  
tcp6 0 0 :::8065 :::\* LISTEN 4823/docker-proxy

actually, when i telnet the service inside the container, it tells me the service isn’t running.

$ telnet [host.com](http://host.com) 8065  
telnet: Unable to connect to remote host: Connection refused

$ docker ps  
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES  
e6d1fea432fe mattermost/platform:helium "/bin/sh -c /go/src/ 4 seconds ago Up 3 seconds 0.0.0.0:8065-\>80/tcp mattermost-dev

$ps axu | grep docker

root 2348 0.0 0.3 125208 1588 ? Sl 05:19 0:00 docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 8065 -container-ip 172.17.0.2 -container-port 80

This is what I have inside the container. it’s not listening to the port.

root@0f14ee67109a:/go/src/github.com/mattermost/platform# netstat -apn | grep 80  
unix 3 [] STREAM CONNECTED 20780 -

root@0f14ee67109a:/go/src/github.com/mattermost/platform# ps axu  
USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND  
root 1 0.0 0.0 4440 100 ? Ss 10:33 0:00 /bin/sh -c /go/src/github.com/mattermost/platform/docker/docker-entry.sh  
root 9 0.0 0.1 17992 936 ? S 10:33 0:00 /bin/bash /go/src/github.com/mattermost/platform/docker/docker-entry.sh  
root 177 0.0 0.3 25340 1688 ? Ss 10:33 0:00 /usr/lib/postfix/master  
root 178 0.1 0.4 35252 2240 ? Sl 10:33 0:02 redis-server _:6379  
root 179 0.0 0.1 17992 688 ? S 10:33 0:00 /bin/bash /go/src/github.com/mattermost/platform/docker/docker-entry.sh  
root 181 0.1 7.6 284852 38488 ? Sl 10:33 0:01 /usr/bin/ruby1.9.1 /usr/local/bin/compass watch  
root 182 0.0 5.4 964796 27496 ? Sl 10:33 0:00 npm  
postfix 187 0.0 0.3 27404 1524 ? S 10:33 0:00 pickup -l -t unix -u -c  
postfix 188 0.0 0.3 27456 1560 ? S 10:33 0:00 qmgr -l -t unix -u  
root 203 0.0 0.1 4444 656 ? S 10:34 0:00 sh -c watchify --extension=jsx -o …/static/js/bundle.js -v -d ./\*\*/_.jsx  
root 204 0.2 21.2 755012 106400 ? Sl 10:34 0:04 node /go/src/github.com/mattermost/platform/web/react/node\_modules/.bin/watchify --extension=jsx -o …/static/js/bundle.js -v  
root 226 0.0 0.4 18240 2084 ? Ss+ 10:51 0:00 /bin/bash  
root 251 0.0 0.4 18148 2008 ? Ss 10:54 0:00 /bin/bash  
root 312 0.0 0.2 15564 1148 ? R+ 11:01 0:00 ps axu

$ ip6tables -L -t nat  
Chain PREROUTING (policy ACCEPT)  
target prot opt source destination

Chain INPUT (policy ACCEPT)  
target prot opt source destination

Chain OUTPUT (policy ACCEPT)  
target prot opt source destination

Chain POSTROUTING (policy ACCEPT)  
target prot opt source destination

how can i start the service inside container to start listening to the port?

---

<div class="post-metadata">

**Author:** ![pro](https://avatars.discourse-cdn.com/v4/letter/p/e56c9b/32.png) [@pro](https://forum.mattermost.com/u/pro)\
**Post date:** [July 14, 2015, 11:52am UTC](https://forum.mattermost.com/t/getting-started/11/14 "2015-07-14T11:52:00Z")

</div>

Rebuilt a local docker image.

ok, finally got it to work. here is what I did:

stop apache2  
change port expose to 8080  
restart the service

ok it stopped working again. can you recommend an OS that is best for Mattermost?

---

<div class="post-metadata">

**Author:** ![it33](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/it33/32/3_2.png) [@it33](https://forum.mattermost.com/u/it33)\
**Post date:** [July 17, 2015, 3:52am UTC](https://forum.mattermost.com/t/getting-started/11/15 "2015-07-17T03:52:26Z")

</div>

Hi @pro, Mattermost has been tested on both Arch and Ubuntu ([https://github.com/mattermost/platform#ubuntu](https://github.com/mattermost/platform#ubuntu)) via Docker and we’re working on testing installs directly to OSs in the next release in about two weeks.

---

<div class="post-metadata">

**Author:** ![tiptronic](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/tiptronic/32/146_2.png) [@tiptronic](https://forum.mattermost.com/u/tiptronic)\
**Post date:** [October 6, 2015, 7:57pm UTC](https://forum.mattermost.com/t/getting-started/11/16 "2015-10-06T19:57:55Z")

</div>

Is there some documentation how to install MM on a subdomain using Reverse proxiing?

- I am running MM in a docker container on a local server
- I am redirecting a subdomain from my provider to my local network (works fine with git, svn, postgre, etc…)
- I am reverse proxying (apache2) the subdomain to a certain port within my local network (e.g. :16800)
- I can login/register, but when I’m logged in it doesn’t communicate… instead I get:

> We cannot reach the Mattermost service. The service may be down or misconfigured. Please contact an administrator to make sure the WebSocket port is configured properly.

However - I haven’t found any hint what else it needs.

Any info appreciated.

Andy  
PS: working INSIDE the local network, everything is fine

---

<div class="post-metadata">

**Author:** ![coreyhulen](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/coreyhulen/32/25_2.png) [@coreyhulen](https://forum.mattermost.com/u/coreyhulen)\
**Post date:** [October 6, 2015, 11:52pm UTC](https://forum.mattermost.com/t/getting-started/11/17 "2015-10-06T23:52:53Z")

</div>

The browser cannot connect to the server via the websocket protocol ws://. In Nginx you would have something like below in your configuration file, which allows the HTTP connection to be upgraded to a WS connection and proxied to Mattermost. I’m not sure what the equivalent is for apache.

````auto
proxy_set_header Connection "upgrade";```
````

---

<div class="post-metadata">

**Author:** ![tiptronic](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/tiptronic/32/146_2.png) [@tiptronic](https://forum.mattermost.com/u/tiptronic)\
**Post date:** [October 7, 2015, 12:27am UTC](https://forum.mattermost.com/t/getting-started/11/18 "2015-10-07T00:27:54Z")

</div>

Well, as I mentioned: that’s what I did - and it works for other services on the same machine.

I am using Apache and configured the VirtualHost to use ReverseProxy (which should be fine).

What I am missing is, which ports MM needs to communicate to it’s service (remember: I can log in and the web-ui is loaded, but communication to the service does not work).

Before digging through the sources, I’m just asking, if there’s some documentation, which ports are used (for what), so I can upgrade the connection at the correct ports 😉

Any info on that?

---

<div class="post-metadata">

**Author:** ![coreyhulen](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/coreyhulen/32/25_2.png) [@coreyhulen](https://forum.mattermost.com/u/coreyhulen)\
**Post date:** [October 7, 2015, 1:11am UTC](https://forum.mattermost.com/t/getting-started/11/22 "2015-10-07T01:11:54Z")

</div>

The web socket is served over the same connection. If you’re able to load the webpage as described, but are seeing the blue bar at the top with the msg “We cannot reach the Mattermost service. …” then the proxy server is blocking the http-\>websocket upgrade. In the default config.json the ListenAddress is 8065. So you need to be able to handle `http://localhost:8065` and `ws://localhost:8065` traffic on the same port.

---

<div class="post-metadata">

**Author:** ![coreyhulen](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/coreyhulen/32/25_2.png) [@coreyhulen](https://forum.mattermost.com/u/coreyhulen)\
**Post date:** [October 7, 2015, 1:17am UTC](https://forum.mattermost.com/t/getting-started/11/23 "2015-10-07T01:17:29Z")

</div>

All the settings for config.json are documented in the `System Console`

![](https://cdck-file-uploads-us1.s3.dualstack.us-west-2.amazonaws.com/flex020/uploads/mattermost/original/1X/d0269d918a60c26cf5505ee8f2c39c7cfaecd77d.png)

[Next page](https://forum.mattermost.com/t/getting-started/11.md?page=2)
