faq.md 6.45 KB
Newer Older
1 2 3 4 5 6 7 8
# FAQ

Frequently asked questions.

## How much does it cost?

Gitter is entirely free for all public and private conversations.

9 10
## I have a suggestion, where can I suggest/discuss it?

11
Feel free to come discuss your idea in the [`gitter/gitter`](https://gitter.im/gitter/gitter) room and create an issue, https://gitlab.com/gitlab-org/gitter/webapp/issues
12 13 14 15


## Help/Support!?!?!

16
If your support inquiry doesn't need to be private, drop by the [`gitter/gitter`](https://gitter.im/gitter/gitter) room.
17

18
Otherwise, send a message to [email protected]
19 20 21 22 23 24 25 26


## Do you have an API?

Why, we are so gladded you asked, **yes** we do.

You can build apps on top of Gitter by using our REST API. You can find more information about it at [developer.gitter.im](https://developer.gitter.im/) or use our [Node.js module](https://www.npmjs.org/package/node-gitter).

27
If you have any questions about our API, please don't hesitate to contact us or join us in our [`gitter/api`](https://gitter.im/gitter/api) chat room.
28

29 30 31

## Can I merge/connect my accounts?

Eric Eastwood's avatar
Eric Eastwood committed
32
See [Accounts](./accounts.md#can-i-mergeconnect-my-accounts)
33 34 35 36


## Can I change my username?

Eric Eastwood's avatar
Eric Eastwood committed
37
See [Accounts](./accounts.md#can-i-change-my-username)
38 39


40
### How do I remove the  `_twitter`/`_gitlab` suffix from my username
41

Eric Eastwood's avatar
Eric Eastwood committed
42
See [Accounts](./accounts.md#how-do-i-remove-the-twitter-suffix-from-my-username)
43 44 45 46


## How do I update my avatar?

Eric Eastwood's avatar
Eric Eastwood committed
47
See [Accounts](./accounts.md#how-do-i-update-my-avatar)
48 49


50 51
## You want write access on my private repos? Are you insane?

52 53 54 55 56 57
See the [GitHub **Private Repositories** section on the **OAuth scopes page**](./oauth-scopes.md#private-repositories)


## You want access to all of my GitLab groups/projects? Are you crazy?

See the [**GitLab** section on the **OAuth scopes page**](./oauth-scopes.md#gitlab)
58 59


60 61 62 63 64
## How do I change my room from public to private?

See [Rooms](./rooms.md#change-room-security-after-creation)


65 66
## Why isn't my GitHub organisation or repos appearing?

67
The first thing to check is [adding private repo access OAuth scope](./oauth-scopes.md#grant-private-repo-access) in order to see a private GitHub repo.
68

69
If it isn't a private repo, the key is to make sure your personal GitHub OAuth scopes and GitHub organisation scopes match(both public and private granted or just public). Check the following pages to see if they match(**Gitter Public Repo Access** and **Gitter Private Repo Access**):
70 71

 - [Personal OAuth application settings](https://github.com/settings/applications)
72 73 74 75 76
 - Organisation OAuth application settings, `https://github.com/organizations/YOURORG/settings/applications`(replace `YOURORG` in the link)

If one of them is missing you can sign out and back in to get **Gitter Public Repo Access** granted personally. And then use the [**Allow private repo access** option from the profile dropdown](./oauth-scopes.md#grant-private-repo-access) in the top-right for **Gitter Private Repo Access**

Once you see the public/private OAuth scopes [listed](https://github.com/settings/applications), you can click on those OAuth apps and **Request** access under the Organization access section:
77

78 79
 - **Gitter Public Repo Access**: https://github.com/settings/connections/applications/e865e74c1d0a3e66003c
 - **Gitter Private Repo Access**: https://github.com/settings/connections/applications/a06939fa3ecb59c27f88
80

81
---
82

83
You can also try making your organisation membership public, `https://github.com/orgs/YOURORG/people`(replace `YOURORG` in the link)
84

85
For more information see [OAuth Scopes](./oauth-scopes.md).
86 87


88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
## What happens if I rename something on GitHub (org, repo)

#### Org rename

Org renames do not happen automatically and require a script to be run manually on our side.

Send a message to [email protected] with the following info. Make sure to email with the primary email address associated with the GitLab/GitHub/Twitter account tied to your Gitter account.

 - Make sure your org membership is public on both the old and new org, `https://github.com/orgs/your-org/people`
 - Link to the old org on GitHub
 - Link to the new org on GitHub
 - Link to the community on Gitter, `https://gitter.im/orgs/your-community/rooms`

#### Repo rename

Repo renames do not happen automatically. Create a new room tied to the repo and we can move the messages over manually. Please note, this will not move room members over.

Send a message to [email protected] with the following info. Make sure to email with the primary email address associated with the GitLab/GitHub/Twitter account tied to your Gitter account.

 - Create a new room tied to the repo
 - Link to where the repo used to exist on GitHub
 - Link to where the repo now exists on GitHub
 - Link to the old room on Gitter
 - Link to the new room on Gitter

#### Transfer repo to a new org

Repo transfers do not happen automatically. Create a new room tied to the repo and we can move the messages over manually. Please note, this will not move room members over.

Send a message to [email protected] with the following info. Make sure to email with the primary email address associated with the GitLab/GitHub/Twitter account tied to your Gitter account.

 - Create a new room tied to the repo
 - Make sure your org membership is public on both the old and new org, `https://github.com/orgs/your-org/people`
 - Link to where the repo used to exist on GitHub
 - Link to where the repo now exists on GitHub
 - Link to the old room on Gitter
 - Link to the new room on Gitter
125 126


127
## What is Gitter Next/staging?
128

129
Gitter Next/staging is where we put our up-coming release branch up for preview. Most of the time it's small changes or even under-the-hood changes you don't see. Sometimes we put pretty large changes up there too and love to hear your feedback.
130 131
Sometimes it blows up, but not very often.

132
You can enable Gitter next in a variety of ways:
133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150

#### Desktop Browser

In your desktop browser, visit http://next.gitter.im and move the giant switchy thing over to next. Then refresh. You will notice a little green pill at the top of your screen that says "NEXT". You are now on Next.

There's also a bookmarklet at the bottom of the Next page and you can add this to your browser things to toggle this pretty easily.

#### Linux and Windows app

There's a convenient little toggle on the Gitter menu of your application to turn Next on or off.

![](https://i.imgur.com/QZJm2MM.png)

#### Mac app

**Gitter** menu bar dropdown in the top-left -> **Use Gitter Next**

![](https://i.imgur.com/YXtPn4N.png)
151 152 153 154 155


## No notifications on mobile (Android, iOS)

See [Notifications](./notifications.md#no-notifications-on-mobile-android-ios)