{% extends "base.html" %} {% load provider_login_url from socialaccount %} {% load trans blocktrans from i18n %} {% block title %} {% trans "Migrate account to GitHub App" %} {% endblock title %} {% block content %}
{% blocktrans trimmed with blog_post="https://about.readthedocs.com/blog/2025/06/announcing-our-github-app-beta/" %} We’re introducing a new GitHub App to replace our old GitHub OAuth app. This new app offers more granular permissions and better GitHub integration. Learn more in our blog post. {% endblocktrans %}
{% if old_github_accounts.count > 1 %} {% endif %}{% blocktrans trimmed %} This guide will help you migrate your account to the new GitHub App. Some things you should know: {% endblocktrans %}
{% blocktrans trimmed %} First, start by connecting your Read the Docs account to our GitHub App. You'll be prompted to grant access to the app. {% endblocktrans %}
{% include "profiles/partials/github_oauth_list.html" with objects=old_github_accounts %} {% trans "Next" %} {% elif step == "install" %}{% blocktrans trimmed %} Next, you will install our GitHub App on each organization and account that has attached repositories. While approving access you will be able to select and deselect individual repositories. {% endblocktrans %}
{% include "profiles/partials/github_app_target_list.html" with objects=installation_target_groups skip_pagination=True %} {% if installation_target_groups %} {% endif %} {% trans "Next" %} {% trans "Skip installation and continue" %} {% elif step == "migrate" %}{% blocktrans trimmed with manual_migration_docs="https://docs.readthedocs.com/platform/stable/reference/git-integration.html#manually-migrating-a-project" connect_docs="https://docs.readthedocs.com/platform/stable/reference/git-integration.html#connect-a-repository-to-an-existing-project" %} After installing our GitHub App on each of your repositories, you will need to migrate your Read the Docs projects to use the new connection. If your project isn't listed, you may need to manually migrate it or connect it to a GitHub repository. {% endblocktrans %}
{% if migration_targets %}{% blocktrans trimmed %} You might need to take additional steps for some projects that can't be migrated automatically. {% endblocktrans %}
{% blocktrans trimmed with manual_migration_docs="https://docs.readthedocs.com/platform/stable/reference/git-integration.html#manually-migrating-a-project" %} The following projects aren't connected to a repository, you need to manually migrate them to use the new GitHub App. {% endblocktrans %}
{% include "profiles/partials/github_app_project_manual_migration_list.html" with objects=manual_migration_required skip_pagination=True %} {% endif %}{% blocktrans trimmed %} Revoke access to our old GitHub OAuth app. You'll be redirected to GitHub, where you need to click on "Revoke access". {% endblocktrans %}
{% if has_projects_pending_migration and not step_revoke_completed %} {% endif %} {% include "profiles/partials/github_oauth_revoke_list.html" with objects=old_github_accounts current_page=request.get_full_path %}{% blocktrans trimmed %} Disconnect the old GitHub OAuth app from your Read the Docs account. {% endblocktrans %}
{% include "profiles/partials/github_oauth_disconnect_list.html" with objects=old_github_accounts %}