NobGit
public nobgit read

Wiki

This is Markdown version of NobGit Docs

Create file Wiki Documentation
Clone
https://nobgit.com/orgs/nobgit/wiki.git
ssh://[email protected]:2222/orgs/nobgit/wiki.git
main default branch main protected 1 commits a7ad6fa Initial commit
Wiki
FILE Deploy with Cloudflare.md File FILE Disconnect accounts and integrations.md File FILE Enable AI inside NobGit.md File FILE How to add a passkey or OTP.md File FILE How to commit to NobGit.md File FILE How to connect Slack.md File FILE How to connect Trello.md File FILE How to connect webhooks.md File FILE How to create an access token.md File FILE How to create an org.md File FILE How to create repo.md File FILE How to get started.md File FILE How to link your Discord account with NobGit.md File FILE How to set up SSO for organizations.md File FILE How to transfer a repo.md File FILE How to upload a GPG key.md File FILE How to upload an SSH key.md File FILE How to upload and use releases.md File FILE How to use the NobGit MCP.md File FILE How to use Wiki.md File FILE Import from GitHub.md File FILE NobGit Docs.md File FILE Page not found.md File

Deploy With Cloudflare

Deploy with Cloudflare

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open Deployment.
  5. In Cloudflare connection, enter a connection name, Cloudflare Account ID, and API token.
  6. Select Save and test connection.
  7. Open the repository you want to deploy.
  8. Visit Settings.
  9. Expand Cloudflare under Integrations.
  10. Check Enable deployments.
  11. Choose an existing Pages project or Worker, or create a new target.
  12. Set branch, build command, and output directory or Worker entry in Advanced build settings.
  13. Select Save Cloudflare integration.

On push, NobGit queues deployments from the Git post-receive hook. Pages deploys upload files from the output directory. Workers deploys upload a JavaScript module entry such as worker.js, index.js, or src/index.js.

Disconnect Accounts And Integrations

Disconnect accounts and integrations

Disconnect integrations

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open Deployment.

Here you can disconnect Cloudflare deployer.

Disable NobGit AI

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open AI Providers.
  5. Uncheck Enable NobGit AI for this account.
  6. Select Save AI status.
  7. Click Disconnect.

Disconnect accounts

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open Linked accounts.

Here you can disconnect Discord and Slack workspaces.

Disconnect Trello

  1. Open the organization you want to disconnect from Trello.
  2. Visit Organization settings.
  3. Under Integrations, expand Trello.
  4. Select Disconnect Trello.

Unlink social logins

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Access.
  4. Open Other Sign in methods.

Here you can unlink Cloudflare, Google, and LinkedIn.

Enable Ai Inside Nob Git

Enable AI inside NobGit

NobGit AI currently supports ChatGPT. Support for Claude and Google Gemini is coming soon.

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open AI Providers.
  5. Create or copy an API key from OpenAI API keys.
  6. Paste the API key into NobGit.
  7. Choose a model you want to use.
  8. Check Enable NobGit AI for this account.
  9. Select Save AI status.

Disable NobGit AI

To turn NobGit AI off later, follow Disconnect accounts and integrations.

How To Add A Passkey Or Otp

How to add a passkey or OTP

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Access.
  4. Open Security.
  5. To add a passkey, use the Passkeys section, enter a name, select Create passkey, and complete the browser or operating system prompt.
  6. To add an authenticator code, use the Authenticator app section, create an OTP key, scan the QR code or copy the manual key, enter the 6-digit code, and select Enable OTP.

How To Commit To Nob Git

How to commit to NobGit

An SSH key or access token is required to push code to NobGit. Password authentication is not supported.

Prepare Git

  1. Install Git on your computer.
  2. Set the name and email address you want on commits.
git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Clone a repository

Open the NobGit repository and use the clone panel to copy either the HTTPS or SSH clone URL.

git clone https://www.nobgit.com/{owner}/{repo}.git
cd {repo}

For HTTPS, use your NobGit username and an access token when Git asks for credentials. For SSH, add an SSH key to NobGit first.

Commit and push changes

  1. Edit or add files in the repository folder.
  2. Review the changed files.
  3. Stage the files you want to commit.
  4. Create the commit.
  5. Push the branch to NobGit.
git status
git add .
git commit -m "Describe your change"
git push origin main

Edit from NobGit

  1. Open the repository in NobGit.
  2. Click the file you want to change.
  3. Edit the file in NobGit.
  4. Write a clear commit message.
  5. Commit the change.

If your repository uses a different default branch, replace main with that branch name. If the push is rejected because the remote has newer commits, run git pull --rebase origin main, resolve any conflicts, and push again.

How To Connect Slack

How to connect Slack

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Integrations.
  4. Open Linked accounts.
  5. Under Slack workspaces, select Connect Slack workspace.
  6. Complete Slack authorization.
  7. Open the repository that should send Slack notifications.
  8. Visit Settings.
  9. Expand Slack under Integrations.
  10. Check Enable Slack push notifications.
  11. Choose the workspace and channel in Slack channel.
  12. Select Save Slack integration.

NobGit sends push summaries from the Git post-receive hook, including branch actions, short SHAs, and commit subjects.

How To Connect Trello

How to connect Trello

  1. Open the organization you want to connect to Trello.
  2. Visit Organization settings.
  3. Under Integrations, expand Trello.
  4. Select Connect Trello.
  5. Authorize NobGit in Trello.
  6. The callback page saves the token returned by Trello.
  7. Choose a Board and List.
  8. Select Save Trello destination.

Trello is configured from organization settings so the organization can use the selected board and list as its Trello destination.

How To Connect Webhooks

How to connect webhooks

  1. Open repository settings for the repository. The repository settings path follows /:owner/:repo/settings.
  2. Expand Webhooks under Integrations.
  3. Enter a Name.
  4. Choose Generic JSON for normal HTTP JSON endpoints, or Discord only for Discord webhook URLs.
  5. Enter an HTTP or HTTPS Webhook URL.
  6. Keep Enable webhook checked.
  7. Select Add webhook.

NobGit immediately attempts a test delivery. Push payloads include event, repository, changes, and delivered_at.

How To Create An Access Token

How to create an access token

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Access.
  4. Open Git access.
  5. Find Expiring access token.
  6. Enter a recognizable Name, such as Work laptop or CI deploy.
  7. Choose an expiration date if the form asks for one.
  8. Select Create token.
  9. Copy the token when NobGit shows it. You will not be able to view the full token again later.

Use access tokens for Git over HTTPS. When Git asks for credentials, enter your NobGit username as the username and paste the access token as the password.

You can revoke active tokens later from Access under Git access and Active tokens.

How To Create An Org

How to create an org

  1. Click your account menu in the top right.
  2. Click Organizations.
  3. Select New organization.
  4. Enter the organization Name.
  5. Add an optional Description.
  6. Optionally upload a PNG, JPG, WEBP, or GIF profile photo.
  7. Select Create organization.
  8. After creating the organization, use Organization settings to update the organization profile, add members, create teams, connect Trello, and configure SAML SSO.

How To Create Repo

How to create repo

  1. Select New repo in the top bar, or import from GitHub.
  2. Choose an Owner: your personal namespace or an organization you own.
  3. Enter a Repository name. NobGit converts it into a URL-safe slug.
  4. Add an optional Description.
  5. Choose Private or Public visibility.
  6. Select Create repository.

After creation, the repository is available at this canonical NobGit URL:

https://www.nobgit.com/{your username or org}/{repo name}

Example:

https://www.nobgit.com/alex/payment-service

We suggest creating a repository named .nobgit for your profile or organization. NobGit uses that special repository's README.md to customize the profile or organization page.

How To Get Started

How to get started

  1. Visit NobGit.
  2. Select Sign up.
  3. Create your account with an email address. Alternatively, choose Continue with Cloudflare, or click More sign-in options to sign up with Google or LinkedIn.
  4. After signing in, use your dashboard for your workspace and Explore for public repositories.
  5. Before pushing code, open Git access settings and create either an expiring HTTPS access token or add an SSH key.
  6. For extra account protection, open security settings and add a passkey or authenticator OTP.

Useful first actions

Create your first repository, add SSH or GPG keys, set up account security, and connect integrations when you need notifications or deployments.

We suggest creating a repository named .nobgit. It is a special repository that lets you customize your profile or organization page with a README.md.

An SSH key or access token is required to push code to NobGit. Password authentication is not supported.

How To Link Your Discord Account With Nob Git

How to link your Discord account with NobGit

  1. Join the NobGit Discord server.
  2. Open the channel called verify.
  3. Click Verify NobGit Account.
  4. Click Verify NobGit Account again.
  5. A page will open in your preferred web browser.
  6. Press Continue with Discord.
  7. Log in with Discord and authorize the login.
  8. Your Discord account is now linked to your NobGit account.

To unlink your Discord account from NobGit

Follow Disconnect accounts and integrations.

How To Set Up Sso For Organizations

How to set up SSO for organizations

  1. Open the organization that should use SSO.
  2. Visit Organization settings.
  3. Expand SAML 2.0 SSO.
  4. Copy the NobGit ACS URL and Entity ID / Metadata URL into your identity provider.
  5. Check Enable SAML SSO.
  6. Enter the IdP Entity ID, IdP SSO URL, optional IdP SLO URL, and IdP X.509 certificate.
  7. Confirm attribute names for email, username, and display name.
  8. Optionally restrict Allowed email domains.
  9. Optionally enable Create NobGit users on first SAML login.
  10. Select Save SAML settings, then use Test SAML sign-in.

Use the NobGit service provider values shown in the SAML panel when configuring your identity provider.

How To Transfer A Repo

How to transfer a repo

  1. Open the repository you would like to transfer.
  2. Visit Settings.
  3. On the right, find Transfer.
  4. Enter the destination organization or account.
  5. Confirm the transfer with your passkey, OTP, or password.
  6. After confirmation, NobGit moves the repository to the destination owner.

How To Upload A Gpg Key

How to upload a GPG key

Generate and export a GPG key

Install GPG first if your system does not already include it. Use the same email address you use for Git commits.

Windows

  1. Install Gpg4win.
  2. Open PowerShell.
  3. Run gpg --full-generate-key.
  4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
  5. List your keys with gpg --list-secret-keys --keyid-format=long.
  6. Export the public key with gpg --armor --export KEY_ID.

macOS

  1. Install GPG with GPG Suite or Homebrew.
  2. Open Terminal.
  3. Run gpg --full-generate-key.
  4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
  5. List your keys with gpg --list-secret-keys --keyid-format=long.
  6. Export the public key with gpg --armor --export KEY_ID.

Linux

  1. Install GPG from your package manager if needed.
  2. Open your terminal.
  3. Run gpg --full-generate-key.
  4. Choose an RSA or ECC key, set an expiration date, and enter your name and email address.
  5. List your keys with gpg --list-secret-keys --keyid-format=long.
  6. Export the public key with gpg --armor --export KEY_ID.

Upload the key to NobGit

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Access.
  4. Open Git access.
  5. Find GPG keys.
  6. Enter a key Name.
  7. Paste the ASCII-armored public key into Public key. It normally starts with -----BEGIN PGP PUBLIC KEY BLOCK-----.
  8. Select Add GPG key.

NobGit syncs the GPG keyring after the key is saved.

How To Upload An Ssh Key

How to upload an SSH key

Generate an SSH key

Use an Ed25519 key unless your system requires a different key type.

Windows

  1. Open PowerShell.
  2. Run ssh-keygen -t ed25519 -C "[email protected]".
  3. Press Enter to accept the default file location.
  4. Optionally enter a passphrase when prompted.
  5. Copy the public key with Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub.

macOS

  1. Open Terminal.
  2. Run ssh-keygen -t ed25519 -C "[email protected]".
  3. Press Enter to accept the default file location.
  4. Optionally enter a passphrase when prompted.
  5. Copy the public key with cat ~/.ssh/id_ed25519.pub.

Linux

  1. Open your terminal.
  2. Run ssh-keygen -t ed25519 -C "[email protected]".
  3. Press Enter to accept the default file location.
  4. Optionally enter a passphrase when prompted.
  5. Copy the public key with cat ~/.ssh/id_ed25519.pub.

Upload the key to NobGit

  1. Click your account menu in the top right.
  2. Click Settings.
  3. Open Access.
  4. Open Git access.
  5. Find Optional SSH key.
  6. Enter a recognizable Key name, such as Work laptop.
  7. Paste the public key into Public key. It should start with a type such as ssh-ed25519.
  8. Select Add SSH key.

Use the SSH clone URL shown in the repository clone panel after the key is saved.

How To Upload And Use Releases

How to upload and use releases

Create a release

  1. Open the repository where you want to publish release files.
  2. Click Releases.
  3. Select the option to upload or create a release.
  4. Enter a release title.
  5. Enter the release version.
  6. Upload release asset files by dragging and dropping them into the upload area, or click the upload area and choose files from your computer.
  7. Review the uploaded assets.
  8. Save or publish the release.

Use a release

  1. Open the repository.
  2. Click Releases.
  3. Open the release you want to use.
  4. Download the release assets you need.
  5. Use checksum or signature files, such as .sha256 or .sig, when the project provides them.

Supported asset formats

Each uploaded file must be 100 MB or smaller.

Most release archives, installers, packages, binaries, checksums, and signatures are supported.

Show supported file extensions

.zip .7z .rar .tar .tgz .gz .bz2 .xz .exe .msi .msp .ipa .app .apk .aab .dmg .pkg .deb .rpm .jar .war .ear .nupkg .gem .whl .crate .vsix .bin .run .wasm .sha256 .sig

Signing and checksums

A GPG public key must already be uploaded to NobGit under Settings> Access> Git access> GPG keys.

For each release asset, generate a detached signature and a checksum file:

  • <asset filename>.asc
  • <asset filename>.sha256

Windows PowerShell example

$key = "211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
$asset = "release\project-1.0.0-win-x64.msi"

gpg --armor --local-user $key --detach-sign `
  --output "$asset.asc" `
  $asset

(Get-FileHash $asset -Algorithm SHA256).Hash.ToLower() + "  " + $asset | Set-Content "$asset.sha256"

gpg --verify "$asset.asc" $asset

macOS Terminal example

key="211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
asset="release/project-1.0.0-macos-universal.dmg"

gpg --armor --local-user "$key" --detach-sign \
  --output "$asset.asc" \
  "$asset"

shasum -a 256 "$asset" > "$asset.sha256"

gpg --verify "$asset.asc" "$asset"

Linux terminal example

key="211D7FF4C389F8CB80F25CC6FB2B56817DA609D6"
asset="release/project-1.0.0-linux-x64.tar.gz"

gpg --armor --local-user "$key" --detach-sign \
  --output "$asset.asc" \
  "$asset"

sha256sum "$asset" > "$asset.sha256"

gpg --verify "$asset.asc" "$asset"

Upload each asset with its matching signature and checksum:

project-1.0.0-win-x64.exe
project-1.0.0-win-x64.exe.asc
project-1.0.0-win-x64.exe.sha256

project-1.0.0-macos-universal.dmg
project-1.0.0-macos-universal.dmg.asc
project-1.0.0-macos-universal.dmg.sha256

project-1.0.0-linux-x64.tar.gz
project-1.0.0-linux-x64.tar.gz.asc
project-1.0.0-linux-x64.tar.gz.sha256

A successful local verification should report a good signature from the key owner.

The .asc filename must exactly match the asset filename plus .asc. NobGit pairs each asset and signature by filename.

Correct:
project-1.0.0-win-x64.msi
project-1.0.0-win-x64.msi.asc

Incorrect:
project.msi.asc
project-1.0.0.asc

How To Use The Nob Git Mcp

How to use the NobGit MCP

Use this MCP server URL in an MCP-capable client:

https://nobgit.com/mcp
  1. When the client opens the NobGit authorization page, sign in with your NobGit account.
  2. Review the client that is asking to connect.
  3. Select the repositories the client should be allowed to use.
  4. Choose whether the connection should have optional write access or read-only access.
  5. Authorize the connection only after the selected repositories and access level look correct.

Repository access

The MCP connection can only use repositories you select during authorization. It stays inside your existing NobGit permissions and does not grant access to repositories your NobGit account cannot already access.

Read access allows the client to inspect selected repository metadata, branches, commit summaries, README files, text file contents, language breakdowns, and issues.

Write access

Optional write access lets MCP tools create issues in selected repositories where your NobGit account already has write access.

Write access never allows direct pushes, branch modifications, repository deletion, permission changes, or organization administration.

Leave write access unchecked when you only want the client to read repository information.

Revoke access

You can revoke MCP access at any time from your NobGit account settings.

MCP provides a standards-based way to connect NobGit with AI assistants and developer tools. Additional native integrations may be added in the future.

How To Use Wiki

How to use Wiki

Wiki is the best way to give users knowledge about your code, project decisions, setup steps, and release notes that do not belong directly in the repository README.

Create wiki pages in the web UI

  1. Open any repository that needs a wiki.
  2. Open Wiki.
  3. Create a page manually from the web UI.
  4. Give the page a clear title and write the content in Markdown.
  5. Save the page.

Use a wiki repository

You can also manage wiki pages with Git by using the repository's .wiki repo. For example, if a NobGit repository is called DotSlash, its wiki repo is called dotslash.wiki.

This lets you push Markdown files to the wiki. The wiki repo is normally hidden from search and does not show in your regular repository list. To make changes, open the repository that has the wiki.

Wiki file format

Wiki pages are Markdown files. Use clear file names so each page maps cleanly to one wiki page.

How to get started.md
How to create repo.md
How to create an access token.md

You can also organize pages into folders:

Get started/
How to get started.md
How to create repo.md
How to create an access token.md

Import From Git Hub

Import from GitHub

  1. Click New repo.
  2. Select Import from GitHub.
  3. Select Connect GitHub.
  4. Choose where to configure the NobGit Importer in GitHub.
  5. Select the GitHub repositories you want to import.
  6. Choose whether each imported repository should belong to you or to one of your organizations.
  7. If you want to rename a repository during import, enter a new name.
  8. Choose the repository Visibility.
  9. Select Import selected to import only the checked repositories, or Import all available to import every available repository.

GitHub connection lifetime

The GitHub token can be manually disconnected, or it will automatically expire after one hour.

Nob Git Docs

NobGit Docs

Practical guides for setting up repositories, account security, organizations, integrations, deployments, and SSO in NobGit.

Guides

Page Not Found

Page not found

The page you requested does not exist in NobGit Docs.

Return to NobGit Docs