Code starts with an overview of your repositories. You can then use the UI to add, delete, and reindex a repo.

Add and delete a repoedit

The Import your first repository page provides step-by-step instructions for adding a GitHub repo to Code. You can fine-tune the hostname of the git clone URL in your kibana.yml file.

For security reasons, Code allows only a few trusted hostnames, such as github.com. To clone private repositories see add an SSH key.

To delete a repository, go to the Repositories tab, find the name of the repo, and click Delete.

Clone private repo with an SSH keyedit

Clones of private repos require an SSH key for authentication. The username associated with your host must have write access to the repository you want to clone.

The following section provides links for generating your ssh key through GitHub. If you already have an SSH key added through your host, skip to step 4.

You can now copy private Git repositories into Code.

To delete a repository, find the go to the Repositories tab, find the name of the repo and click Delete.

Reindex a repoedit

Code automatically reindexes an imported repo at set intervals, but in some cases, you might need to refresh the index manually. For example, you might refresh an index after a new language server installs. Or, you might want to update the index to the HEAD revision immediately. Click Reindex to initiate a reindex.

Clone URL managementedit

For security reasons, Code only allows the following hostnames in the git clone URL by default:

You can add your own hostname (for example, acme.com) to the whitelist by adding the following line to your config/kibana.yaml file:

xpack.code.security.gitHostWhitelist: [ "github.com", "gitlab.com", "bitbucket.org", "gitbox.apache.org", "eclipse.org", "acme.com" ]

Set xpack.code.security.gitHostWhitelist to [] (empty list) allow any hostname.

You can also control the protocol to use for the clone address. By default, the following protocols are supported: [ 'https', 'git', 'ssh' ]. You can change this value by adding the following line to your config/kibana.yaml file. In this example, the user only wants to support the https protocol:

xpack.code.security.gitProtocolWhitelist: [ "https" ]

Limitationsedit

Consider the following limitations before cloning repositories: