> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# Self-hosted backends overview

> Six open-source support APIs: purpose, defaults, and GitHub repos

Most users **do not** need to self-host. Starcat ships with default Fly.io endpoints and baked-in API keys.

This topic is for advanced users who want to inspect the source, run APIs locally, or point Explore / Weekly / Sharing at their own instances.

## Services

| Service       | Used for (in-app)                       | Default production URL                  | Local port | GitHub                                                                        |
| ------------- | --------------------------------------- | --------------------------------------- | ---------- | ----------------------------------------------------------------------------- |
| **Trending**  | Explore → Trending                      | `https://starcat-trending-api.fly.dev`  | `5002`     | [starcat-trending-api](https://github.com/starcat-app/starcat-trending-api)   |
| **Weekly**    | Explore → Weekly                        | `https://starcat-weekly-api.fly.dev`    | `5003`     | [starcat-weekly-api](https://github.com/starcat-app/starcat-weekly-api)       |
| **Discovery** | Explore → Discover / Hot / New releases | `https://starcat-discovery-api.fly.dev` | `5006`     | [starcat-discovery-api](https://github.com/starcat-app/starcat-discovery-api) |
| **Wiki**      | Wiki / external docs probes             | `https://starcat-wiki-api.fly.dev`      | `5004`     | [starcat-wiki-api](https://github.com/starcat-app/starcat-wiki-api)           |
| **Recommend** | Similar-repository recommendations      | `https://starcat-recommend-api.fly.dev` | `5005`     | [starcat-recommend-api](https://github.com/starcat-app/starcat-recommend-api) |
| **Sharing**   | AI share pages / short links            | `https://starcat-sharing-api.fly.dev`   | `5001`     | [starcat-sharing-api](https://github.com/starcat-app/starcat-sharing-api)     |

<Note>
  The Direct license / payment backend is **not** listed under **Settings → Services** and is out of scope here.
</Note>

## Auth conventions

* Business and probe routes: `/api/v1/*` require `Authorization: Bearer <API_KEY>`
* Liveness: `GET /healthz` is **unauthenticated** (status-bar availability)
* Settings **Test connection**: `GET /api/v1/ping` (URL + key + service identity)

Keys usually look like `sk-starcat-` plus 32 characters. Generate with each repo’s README guidance or the monorepo script `supports/scripts/gen-api-key.sh`.

## Next

1. [Deploy](/self-hosting/deploy) — local or Fly.io
2. [Configure in Starcat](/self-hosting/configure) — **Settings → Services**

Related product docs: [Explore overview](/discover/explore/overview), [Weekly](/discover/weekly/weekly), [Trending](/discover/trending/trending), [Share cards](/share-export/share-cards).