FAQs

General Questions

Where are my data stored? Is it secure?
GitLab Control stores your data both online (on your host) and locally. We use the device keychain to store your credentials and an encrypted database to store all the others data. Every message transferred is encrypted with TLS/SSL only when the appropriate option is enabled both on the app and on your GitLab instance.
What are the minimum requirements?
GitLab Control requires at least iOS 8.1 on the iPhone, iPod Touch, iPad and iPad Mini.
It currently supports GitLab server version 9.x and higher, but it is highly optimized for GitLab 10.x.
Please note that some of the features may not be available or not work at all on versions prior to 9.0.
Is LDAP authentication supported?
GitLab API supports LDAP authentication only since version 6.0 and higher. Read more here.
Invalid host, what can I do?
The most common reason is that GitLab Control is not able to reach the GitLab server API.

Make sure to check the following:

  • If your server is not public, make sure your device is on the same private network.
  • Your GitLab server is version 9.x or higher.
  • Your GitLab server API must be publicly accessible.

In order to check that your GitLab server is configured properly for GitLab Control to work, run the following on terminal:

curl "https://YOURSERVER:YOURPORT/api/v4/user"

If you see something similar to “401” everything works as expected:

HTTP/1.1 401 Unauthorized
Server: nginx
Content-Type: application/json
{"message":"401 Unauthorized"}

if you see, something similar to “302”, it means that you have a proxy configured in a way that is denying access to the GitLab server API:

HTTP/1.1 302 Found
Server: nginx
<html><body>You are being <a href="https://yourserver.com/users/sign_in">redirected</a>.</body></html>

In this case, you should contact your system administrator and ask for the problem to be fixed.

if you still can’t connect, please contact [email protected]

Invalid credentials, what can I do?
Make sure to check the following:

– You are typing your credentials correctly.
– You are not using any custom keyboard that may add additional characters to the input fields.

Another reason may be that your GitLab server instance doesn’t support username/password authentication for 3rdParty applications.
If that’s the case, you’ll have to authenticate using “Private Token” authentication.
In GitLab Control, on the login screen, please the little gear icon on the bottom right, then flip the switch, paste your token and you should be good to go.

if you still can’t connect, please contact [email protected]

How do I change the language of the app?
GitLab Control language settings depend on your device language preferences.

Go to Settings App > General > International > Language

Do you plan to develop an android version of the app?
We are totally focused on iOS at the moment supporting iPhone, iPad and iPod Touch devices. Android may come in the future, but there are no plans for it at the moment.
Where can I buy GitLab Control Pro?
GitLab Control Pro is available as an In-App Purchase. Read more about the features available.
Can I pay for my employees?
You can use the Gift feature on the iOS App Store to offer GitLab Control to your employees.
My app is in the wrong language, how do I fix it?
An iOS device keeps track of which languages you have set the locale to. If the currently selected locale is unsupported in an app, then the device will use the last user-selected language you used that is supported by the application.

For example:
Imagine you had changed your device to English, then Italian, then Spanish. The app would first try and provide a Spanish localization. If one wasn’t available, it would attempt Italian. If that wasn’t available, then it would finally use English.

So, if for example your device language is set to German (which is not supported by the app), but for some reason you previously switched your device language to Italian (which Is supported) then the app will default to Italian.

To restore the English language (for any app). Change the device language to English and then back to your original language.

My app crashes, how do I fix it?
First of all, make sure you are using the latest version of the app.

Try restarting your device.

If restart did not help, do the following:

  • Remove the app from your device
  • Restart your device
  • Reinstall the app

NOTE: sometimes installing on your device any software that is not authorized by Apple may cause unstable operation of the app.

Is GitLab Control the official GitLab app?
GitLab Control is published by Valerio Mazzeo and it is not affiliated with GitLab B.V. in any way.