GitHub Versioning allows your team to manage Notebook code through Git workflows, enabling automated deployments, better collaboration, and full auditability.
With GitHub Versioning enabled, you can link any Notebook in Nekt to a GitHub repository. Once connected, every update pushed to the repository’s main branch will automatically trigger a redeploy of the Notebook in Nekt — no more manual updates required.
Check it in action on the video below:
1. Connect Your GitHub Organization
Before linking repositories, you must authorize Nekt’s GitHub app within your GitHub Organization.
- Navigate to Settings → GitHub inside Nekt.
- Click Connect GitHub.
- Approve installation of the Nekt GitHub App on your GitHub Organization.
This step does not appear in the tutorial video. It is mandatory to complete before assigning repositories.
2. Prepare Your Repository
Create a repository in GitHub that will store your Notebook’s code.
- The repository can be empty (no files, no branches).
- You can use an existing repo, but we recommend a clean, dedicated one for each Notebook for clarity and isolation.
3. Link the Repository in Nekt
You can associate a repo either when creating a new Notebook or editing an existing Notebook.
When Creating a New Notebook
During notebook creation, you will see an option to select a GitHub repository. Choose the repository you created.
When Editing an Existing Notebook
- Open the Notebook.
- Go to Settings → GitHub Integration.
- Select the desired GitHub repository.
4. Automatic Deployments
Once a Notebook is linked:
- Any push to the main branch automatically redeploys the Notebook inside Nekt.
- No manual updates are required—your Notebook stays in sync with your GitHub version.
This ensures a simple, deterministic, and auditable workflow aligned with standard engineering practices.
Need Help?
If you encounter challenges while setting it up, our team is ready to assist. 
