--- title: Forgejo hack #2: Integration with Read The Docs | daily.dev description: A step-by-step walkthrough shows how to manually connect a self-hosted Forgejo repository to Read the Docs so that pushes trigger documentation builds, since... canonical: https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Forgejo hack #2: Integration with Read The Docs | daily.dev og:description: A step-by-step walkthrough shows how to manually connect a self-hosted Forgejo repository to Read the Docs so that pushes trigger documentation builds, since... og:url: https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf og:image: https://api.daily.dev/og/posts/6fcXUYdBf.png og:image:alt: Forgejo hack #2: Integration with Read The Docs og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Forgejo hack #2: Integration with Read The Docs **[Miguel Grinberg](https://daily.dev/sources/miguelgrinberg)** · 5 min read · 0 upvotes · 0 comments ## Summary A step-by-step walkthrough shows how to manually connect a self-hosted Forgejo repository to Read the Docs so that pushes trigger documentation builds, since Read the Docs does not natively support Forgejo yet. The trick involves deleting the existing GitHub webhook integration on Read the Docs, setting a manual repository URL, creating a fake 'GitHub incoming webhook' integration, and wiring up a matching Forgejo webhook since Forgejo's webhook payload format is compatible with GitHub's. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How do I trigger Read the Docs builds automatically from a self-hosted Forgejo repository? Create a manually configured repository URL in Read the Docs project settings, then add a new integration and select 'GitHub incoming webhook' as the type even though the repo is on Forgejo, since Forgejo's webhook payload format is compatible with GitHub's. Copy the resulting webhook URL and secret into a new Forgejo webhook configured with HTTP method POST and trigger set to push events. _daily.dev surfaces workarounds like this for teams wiring self-hosted git tooling into existing CI and docs pipelines._ ### Does Read the Docs natively support Forgejo repositories? No, Read the Docs does not currently offer a built-in integration for repositories hosted on Forgejo, unlike GitHub which gets an automatic webhook integration. A manual workaround is required: deleting the GitHub webhook integration, setting a manually configured repository URL, and tricking Read the Docs into accepting a Forgejo webhook by choosing the GitHub integration type. _developers evaluating self-hosted git platforms can track docs and CI integration gaps on daily.dev._ ## Similar posts on daily.dev - [I moved all my side projects off GitHub to Forgejo, and my workflow stayed exactly the same](https://daily.dev/posts/i-moved-all-my-side-projects-off-github-to-forgejo-and-my-workflow-stayed-exactly-the-same-q7qk4aw98) · XDA Developers · 19 upvotes · 8 comments - [Forgejo v15.0 is available](https://daily.dev/posts/forgejo-v15-0-is-available-gfjkjnve8) · Lobsters · 0 upvotes · 0 comments - [Why I'm leaving GitHub for Forgejo](https://daily.dev/posts/why-i-m-leaving-github-for-forgejo-8ezk0te27) · Hacker News · 145 upvotes · 30 comments - [GitHub → Codeberg: my experience](https://daily.dev/posts/github-codeberg-my-experience-sgumrctwf) · Lobsters · 5 upvotes · 0 comments --- Tags: [#github](https://daily.dev/tags/github), [#git](https://daily.dev/tags/git), [#forgejo](https://daily.dev/tags/forgejo) [View this post on daily.dev](https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Forgejo hack #2: Integration with Read The Docs","url":"https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf"},"datePublished":"2026-10-11T12:28:43.120Z","dateModified":"2026-10-11T12:29:45.539Z","description":"A step-by-step walkthrough shows how to manually connect a self-hosted Forgejo repository to Read the Docs so that pushes trigger documentation builds, since...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/0badf73a7174f047133cbb0df19cac5e?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/0badf73a7174f047133cbb0df19cac5e?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Miguel Grinberg","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Miguel Grinberg","logo":"https://media.daily.dev/image/upload/s--1lzsuTn2--/f_auto,q_auto/v1777800749/logos/miguelgrinberg?_a=BAMAMiWQ0","url":"https://daily.dev/sources/miguelgrinberg"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"github,git,forgejo","timeRequired":"PT5M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Miguel Grinberg","item":"https://daily.dev/sources/miguelgrinberg"},{"@type":"ListItem","position":3,"name":"Forgejo hack #2: Integration with Read The Docs"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/forgejo-hack-2-integration-with-read-the-docs-6fcxuydbf#faq","mainEntity":[{"@type":"Question","name":"How do I trigger Read the Docs builds automatically from a self-hosted Forgejo repository?","acceptedAnswer":{"@type":"Answer","text":"Create a manually configured repository URL in Read the Docs project settings, then add a new integration and select 'GitHub incoming webhook' as the type even though the repo is on Forgejo, since Forgejo's webhook payload format is compatible with GitHub's. Copy the resulting webhook URL and secret into a new Forgejo webhook configured with HTTP method POST and trigger set to push events. daily.dev surfaces workarounds like this for teams wiring self-hosted git tooling into existing CI and docs pipelines."}},{"@type":"Question","name":"Does Read the Docs natively support Forgejo repositories?","acceptedAnswer":{"@type":"Answer","text":"No, Read the Docs does not currently offer a built-in integration for repositories hosted on Forgejo, unlike GitHub which gets an automatic webhook integration. A manual workaround is required: deleting the GitHub webhook integration, setting a manually configured repository URL, and tricking Read the Docs into accepting a Forgejo webhook by choosing the GitHub integration type. developers evaluating self-hosted git platforms can track docs and CI integration gaps on daily.dev."}}]} ```