> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digitalasset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Troubleshooting and FAQ for common operational issues

## Unable to authenticate with GitHub

Verify:

* GitHub App ID
* Installation ID
* Private key Secret
* The application has been installed into the correct repository

***

## DARs are not synchronizing

Verify:

* Repository owner and name
* Branch and directory (if configured)
* Repository permissions
* GitHub App installation

***

## External parties are not being onboarded

Verify:

* Correct Kubernetes secret for connectivity to Ledger API
* Ledger API endpoint
* Admin API endpoint
* Participant IDs in configuration file are correct
* 3 participants have been referenced in the onboarding request
* Onboarding request had expected threshold (2 of 3)

***

## Unable to connect to the participant

Check:

* Ledger API endpoint
* Admin API endpoint
* OIDC issuer configuration
* Client credentials
* Network connectivity

***

## Security Considerations

* Store all credentials in Kubernetes Secrets.
* Do not commit GitHub private keys to version control.
* Grant only the minimum required GitHub permissions.
* Rotate GitHub App keys periodically.
* Limit Kubernetes Secret access using RBAC.

***