--- title: Linking code from Azure Devops Server sidebarTitle: Azure Devops Server icon: https://www.svgrepo.com/show/448307/azure-devops.svg --- import AzureDevopsSchema from '/snippets/schemas/v3/azuredevops.schema.mdx' If you're not familiar with Sourcebot [connections](/docs/connections/overview), please read that overview first. ## Examples This is required if you're using an older version of ADO Server which has `/tfs` in the repo paths. ```json { "type": "azuredevops", "deploymentType": "server", "useTfsPath": true, "repos": [ "organizationName/projectName/repoName", "organizationName/projectName/repoName2 ] } ``` ```json { "type": "azuredevops", "deploymentType": "server", "repos": [ "organizationName/projectName/repoName", "organizationName/projectName/repoName2 ] } ``` ```json { "type": "azuredevops", "deploymentType": "server", "orgs": [ "collectionName", "collectionName2" ] } ``` ```json { "type": "azuredevops", "deploymentType": "server", "projects": [ "collectionName/projectName", "collectionName/projectName2" ] } ``` ```json { "type": "azuredevops", "deploymentType": "server", // Include all repos in my-org... "orgs": [ "my-org" ], // ...except: "exclude": { // repos that are disabled "disabled": true, // repos that match these glob patterns "repos": [ "reposToExclude*" ], // projects that match these glob patterns "projects": [ "projectstoExclude*" ] // repos less than the defined min OR larger than the defined max "size": { // repos that are less than 1MB (in bytes)... "min": 1048576, // or repos greater than 100MB (in bytes) "max": 104857600 } } } ``` ## Authenticating with Azure Devops Server Azure Devops Server requires you to provide a PAT in order to index your repositories. To learn how to create PAT, check out the [Azure Devops docs](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows). Sourcebot needs the `Read` access for the `Code` scope in order to find and clone your repos. Next, provide the access [token](/docs/configuration/config-file#tokens) via an environment variable which is referenced in the `token` property: 1. Add the `token` property to your connection config: ```json { "type": "azuredevops", "deploymentType": "server", "token": { // note: this env var can be named anything. It // doesn't need to be `ADO_TOKEN`. "env": "ADO_TOKEN" }, // At least one of the following is required to specify which repos to sync: "repos": ["collectionName/projectName/repoName"], // "orgs": ["collectionName"], // "projects": ["collectionName/projectName"] } ``` 2. Pass this environment variable each time you run Sourcebot: ```bash docker run \ -e ADO_TOKEN= \ /* additional args */ \ ghcr.io/sourcebot-dev/sourcebot:latest ``` ## Schema reference [schemas/v3/azuredevops.json](https://github.com/sourcebot-dev/sourcebot/blob/main/schemas/v3/azuredevops.json)