Git Hosts

Git Hosts

Bespok3d connects to a Git host (GitHub or a self-hosted Gitea instance) to browse plugin repositories and, if you're a plugin author, to publish releases. It's optional — you don't need a Git host connection to enroll printers or install plugins from a local source.

---

What a Git host is used for

• Plugin browsing — discover plugins hosted in GitHub/Gitea repos
• Publishing — create signed releases in your own repos when publishing a plugin
• Registry hosting — your plugin lists can live in a repo and update as you push

---

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

The token has repo scope (to read and create releases). If you only want to browse public plugins, the scopes needed are minimal and you can revoke access from your GitHub settings at any time.

---

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 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 → Connect Gitea
5. Enter your Gitea instance URL and paste the token

---

Managing the connection

The Git Host settings screen 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.