Skip to main content
Version: 0.12

Private Repositories

GitHub Private Repositories

Okteto integrates with GitHub and allows you to easily deploy any repository from any account or organization you grant permissions to. You can connect both personal repositories and those belonging to an organization in the same Okteto account.

Grant permissions

You'll need to perform the following steps the first time you grant GitHub permissions to Okteto:

  1. Log into Okteto Cloud

  2. Click on the "Launch Dev Environment" button on the top

  3. Make sure "GitHub" is the selected source

    Launch private repository from git

  4. Click on the Configure GitHub button, to open the authorization dialog from GitHub. GitHub will ask you to install the Okteto Cloud App in the accounts and organizations you select. Follow the instructions to grant permissions to your repositories.

    install Okteto Cloud

  5. Finally click on the Install & Authorize button to proceed. If you're not the administrator of the organization, GitHub will send an email notification to your administrator and wait for their authorization to complete the installation and grant you access.

    install and authorize repositories

Once you or your administrator grants permission, Okteto will automatically list your private and public repositories in the Launch dialog.

list of private repositories

Private repositories will be identified by a "lock" icon.

locked private repositories

GitHub org administrators

If you're an administrator, you can grant team members access to your organization's repositories. Please note, even if you grant Okteto permission to all of your organization's repositories, each developer will only have access to those repositories that they are able to access through GitHub. This allows you to maintain security, and ensure that only those authorized to access code may do so.

Update permissions

You can update or revoke the permissions over your private repositories or organizations by going to the Integrations tab in the Settings page.

update private repositories

Click on the Configure button to update your permissions and access GitHub's configuration flow.

Launch from a Private GitHub Repository

After giving Okteto access to any of your public or private repositories, you'll be able to deploy from a GitHub repository using an Okteto Manifest.