Git Hosts

Git Hosts

Bespok3d connects to a Git host (GitHub or a self-hosted Gitea instance) to manage your public key identity and, when available, to publish plugin releases. A Git host connection is optional — you do not need one to enroll printers or browse the plugin catalog.

---

What a Git host is used for

• Key publishing — upload your GPG public key to a repo so others can verify packages you sign (see Keys)
• Plugin publishing — create signed releases in your own repos when you publish a plugin (coming soon)
• Registry hosting — your plugin lists can live in a repo and update as you push (coming soon)

---

Connecting GitHub

Bespok3d uses GitHub's device flow — you never type your password into the app.

1. Go to Settings → Git Host
2. Click Connect GitHub
3. The app shows you a short code (like ABCD-1234)
4. Open github.com/login/device in your browser, enter the code, and authorise
5. Done — the app stores your token securely in the OS keychain

You can revoke access at any time from your GitHub account under Settings → Applications.

---

Connecting Gitea

For a self-hosted Gitea instance, Bespok3d uses a Personal Access Token (PAT).

1. In your Gitea instance, go to Settings → Applications → Generate Token
2. Give it a name (e.g. bespok3d) and set at minimum read:repository scope; add write:repository if you plan to publish
3. Copy the token
4. In Bespok3d go to Settings → Git Host, select Gitea, enter your instance URL and paste the token
5. Click Save — the app validates the connection and shows your username

The token is stored in the OS keychain via Electron safeStorage and is never written to disk in plaintext.

---

Managing plugin and list repositories

Once a Git host is connected, Settings → Git Host shows two sections: Plugin repositories and List repositories.

• Add a repo by typing owner/repo or selecting from the autocomplete list of your repos
• Removing a repo removes it from the list; no data in the repo is deleted
• Repos configured here activate the corresponding purpose chips in Settings → Keys — the Packages chip becomes active when at least one plugin repo is configured

---

Managing the connection

The Git Host pane shows the connected account and lets you:

• Disconnect — removes the stored token. Nothing on GitHub/Gitea is affected.
• Switch account — disconnect and reconnect with a different account or instance.

You can have one GitHub connection and one Gitea connection active at the same time.