DIYgod/RSSHub · error · ConfigNotFoundError

GitHub follower RSS is disabled due to the lack of <a href="

Error message

GitHub follower RSS is disabled due to the lack of <a href="https://docs.rsshub.app/deploy/config#route-specific-configurations">relevant config</a>

What it means

Thrown as a ConfigNotFoundError by the GitHub Followers route when config.github.access_token is not set. The route uses the GitHub GraphQL API to fetch a user's followers, which requires authentication. The guard pattern is identical to other GitHub routes: 'if (!config.github || !config.github.access_token)'.

Source

Thrown at lib/routes/github/follower.ts:31

        requirePuppeteer: false,
        antiCrawler: false,
        supportBT: false,
        supportPodcast: false,
        supportScihub: false,
    },
    radar: [
        {
            source: ['github.com/:user'],
        },
    ],
    name: 'User Followers',
    maintainers: ['HenryQW'],
    handler,
};

async function handler(ctx) {
    if (!config.github || !config.github.access_token) {
        throw new ConfigNotFoundError('GitHub follower RSS is disabled due to the lack of <a href="https://docs.rsshub.app/deploy/config#route-specific-configurations">relevant config</a>');
    }
    const user = ctx.req.param('user');

    const host = `https://github.com/${user}`;
    const url = 'https://api.github.com/graphql';

    const response = await got({
        method: 'post',
        url,
        headers: {
            Authorization: `bearer ${config.github.access_token}`,
        },
        json: {
            query: /* GraphQL */ `
            {
                user(login: "${user}") {
                  followers(first: 10) {
                    edges {

View on GitHub (pinned to bed535e087)

Solutions

  1. Set GITHUB_ACCESS_TOKEN environment variable to a valid GitHub personal access token
  2. For Docker: add -e GITHUB_ACCESS_TOKEN=ghp_xxxx to your run command
  3. Verify the token has no special scope requirements (public read access is sufficient for followers)
  4. Restart the RSSHub process after configuration

Example fix

// Configuration fix, not code change:
// Set environment variable GITHUB_ACCESS_TOKEN=ghp_your_token
// Restart RSSHub
Defensive patterns

Strategy: validation

Validate before calling

// Pre-flight config check
if (!config.github?.access_token) {
    throw new ConfigNotFoundError('GITHUB_ACCESS_TOKEN is required for GitHub follower feeds');
}

Type guard

function hasGitHubToken(cfg: typeof config): cfg is typeof config & { github: { access_token: string } } {
    return !!cfg.github?.access_token;
}

Prevention

When it happens

Trigger: Any request to /github/user/followers/:user when GITHUB_ACCESS_TOKEN is not configured in the RSSHub environment. The token is needed because the GraphQL followers query requires authentication.

Common situations: New RSSHub instance without GITHUB_ACCESS_TOKEN; the token was revoked or expired; the env var name is misspelled; deploying to a platform (Vercel, Railway) without adding the env var.

Related errors


AI-assisted analysis of DIYgod/RSSHub@bed535e087 (2026-08-12). Data as JSON: /api/errors/93b309483d4e6cf2. Report an issue: GitHub.