How to set up the GitLab integration?
LingoHub provides a GitLab integration that lets users quickly and easily localize repository files. To connect a GitLab repository to LingoHub, you must first generate a Project access token with the required permissions, then configure authentication in your LingoHub workspace.
Create a GitLab access token
Follow these steps to generate the required credentials in GitLab:
Sign in to your GitLab account and navigate to the repository you want to connect.
In the left-hand sidebar, go to Settings > Access tokens.
Click Add new token.
Provide a Token name (e.g., "LingoHub Integration").
Select an Expiration date.
Note: If no date is selected, the token expires in 365 days. GitLab project tokens have a maximum lifespan of 365 days.
Select a Role: You must select at least Developer to ensure LingoHub has sufficient permissions to sync files.
Select Scopes: Check the api box. This grants LingoHub the necessary read/write access to manage your resource files.
Click Create project access token.
Copy the token immediately. Save it in a secure place, as you will not be able to access it again after leaving the page.
Connect GitLab to LingoHub
Once you have your token, you can add the authentication to your LingoHub workspace:
Navigate to Plugins and integrations.
Find the GitLab plugin and click Manage.
Click Add new GitLab authentication.
In the window that appears, provide the following information:
Name: A label for this connection (e.g., "Main GitLab Account").
Self-hosted: Toggle this on if you are using a self-hosted GitLab instance; otherwise, leave it off for gitlab.com.
Provider URL: Enter https://gitlab.com or your custom instance URL.
Access token: Paste the token you generated in Step 1.
Click Create.
Create a new LingoHub project
Now that the authentication is configured, you can use it to create a synchronized project in LingoHub:
Click Create project on your LingoHub dashboard.
Enter your Project name.
Under Select project category, choose GitLab.
Note: The GitLab integration is file-based. Platforms like Contentful, Figma, Storyblok, and Zendesk use different connection methods.
Click Continue and follow the instructions to select your specific repository and branch.
Once your project is created, you can manage your synchronization settings (such as resource filters and automatic pull/push) by navigating to the project Settings > Integration (GitLab).
This comprehensive Help Center article on managing your project repository integrations explains the most important settings.
Awesome! You have finished the article on setting up the GitLab integration. We hope that it helped you find answers to all your questions. Otherwise, contact our support, and we will gladly help!