GitLab Setup

#Step-by-step GitLab setup

#Step 1 — Create a Personal Access Token

1. Go to GitLab → Settings → Access Tokens (or /‑/profile/personal_access_tokens)
2. Click Add new token
3. Set a name: SXL Studio
4. Set scopes:
   • api — full access (recommended)
   • Or minimal: read_repository + write_repository
5. Click Create personal access token
6. Copy the token — it's shown only once

#Step 2 — Determine the project path

In GitLab, a repository is identified by project path or numeric Project ID:

• Path: namespace/project-name (e.g. design-team/tokens)
• Project ID: number from Settings → General page (e.g. 12345)

Both work in the Repository field.

#Step 3 — Create a connection

1. Open SXL Studio → Sync panel
2. Click New Sync
3. Fill in the form:

4. Click Save

#Step 4 — First sync

1. Click Pull — the plugin downloads files
2. Check the data in the plugin
3. Try Push to verify writing works

---

#Self-hosted GitLab

For your own GitLab server:

1. In the Enterprise URL field, enter the base URL: https://gitlab.company.com
2. The plugin automatically appends /api/v4 for the REST API
3. Create the token on your server the same way

---

#Troubleshooting

#"Not Found"

• Check the project path or Project ID
• Make sure the token has access to the project

#"Unauthorized" or "Forbidden"

• Check the token scopes: needs api or read_repository + write_repository
• For self-hosted: verify the Enterprise URL is correct

#Project in a subgroup

• Use the full path: group/subgroup/project

---

#Related sections

• Git — Integration — general overview
• GitHub Setup — alternative provider