I've been using GitBook for documentation in some of my projects, but I'm increasingly running into limitations with their free tier, and I'm not a fan of relying on their cloud service. I'd prefer to self-host a similar solution for better control and customization.

Ideally, I'm looking for a self-hosted alternative that offers:

• Markdown support

• Clean, modern UI like GitBook

• Easy navigation/sidebar structure

• Version control integration (Git preferably)

• Good search functionality

Ability to collaborate with others I know there are options like BookStack, DokuWiki, and MDBook out there, but I'd love to hear from anyone who's made the switch from GitBook to a self-hosted solution. What worked well for you? Any implementation challenges I should be aware of?

Thanks in advance!

UPDATE: Thanks for all the suggestions—super helpful!

Just wanted to mention that I ended up trying out Apidog's self-hosted docs and it’s been a really solid alternative to GitBook for my needs. It supports Markdown, has a clean and modern UI, and the sidebar/navigation setup feels very familiar.

It also integrates with Git for version control, which was important for me, and the search has been decent so far. I’ve been using it for about 6 months now after hitting the limits of GitBook’s free tier, and I’ve been really happy with it. The self-hosting setup was pretty straightforward if you follow their guide.

If you’re looking for something GitBook-like but with more control, it’s definitely worth a look.

Hi,

This is probably not the right subreddit, but I have no better idea.

Do you know an alternative to gitbook? I get so annoyed by this tool. It breaks all the time. The editor really sucks, makes it basically unusable and because tables are converted to html with a broken formatting I can't edit them in the code anymore. I am so pissed, it gets worse and worse.

We love gitbook, but hate the fact the pricing is unpredictable + it's not FOSS :(, so we built something that we could use for our documentation needs. We were big fans of docusaurus and RsPress (like docusaurus but built with rust based tools) but onboarding non-technical people to use it was a pain.

Introducing kalmia! It's free (as in freedom with AGPLv3), it's pretty, it's blazingly fast. If you want to know more details about it you can read about it on our blog or just go straight to the github/docs.

PS: It's a very early stage product so there might be a few bugs/breaking changes!

I want an alternative that doesn't require me to write md code like most other alternatives do, i want it to be like gitbook where u drag and press buttons to add stuff

Hello everyone. I have tried to make a gitbook document for my project but I cannot post it since gitbook is supposedly paid.... Is there any alternative to it?

I'm over WordPress, I think they have gone too far with trying to make an editor that is all things to all people and I find editing to be very distracting. I am writing technical documentation and need it to be precise rather than fancy.

I really like GitBook, but I want to retain creative and hosting control.

Is there a self hosted version of something like GitBook?

Many thanks.

Hello,

I've been using GitBook for at least four years. The reason I chose it was its ability to create a subdomain like 'docs.example.co'.

However, when I logged in this morning, I noticed that I won't be able to create a subdomain anymore. They are forcing me to upgrade to the Pro plan.

I'm looking for similar tools that will allow me to reuse my old content and create subdomains.

Any suggestions would be much appreciated.

Thanks!

Hi, I need a Gitbook like website that can publish a document for free. Anyone knows any alternatives and how to do it? or... if i can do something like gitbook can but, in a downloadable pdf or in a way that I can publish the page on my wix website?

We love gitbook, but hate the fact the pricing is unpredictable + it's not FOSS :(, so we built something that we could use for our documentation needs. We were big fans of docusaurus and RsPress (like docusaurus but built with rust based tools) but onboarding non-technical people to use it was a pain.

Introducing kalmia! It's free (as in freedom with AGPLv3), it's pretty, it's blazingly fast. If you want to know more details about it you can read about it on our blog or just go straight to the github/docs.

PS: It's a very early stage product so there might be a few bugs/breaking changes!

Hi,

I'm looking for some good/decent Gitbook alternatives which are open-source and based on Reactjs. My requirement is to create documentation website for my open-source projects and then host it on github pages.

Please comment down the name of the project if you know any. Thanks!

Yeah so we've been using GitBook for a while now and the new pricing is just... not it. Need to move our API docs somewhere else before renewal hits.

We're looking at like 50-100 pages of docs, heavy on code examples, need good search, and ideally something that doesn't require us to completely rebuild everything we've already got. Also need it to look decent because we actually show this to clients.

The stuff I'm seeing people recommend are Notion (free tier exists but feels janky for this), Mintlify (looks really slick but I'm not sure how production-ready it is), and just going full static site with Hugo or something. There's also Stoplight and ReadTheDocs but those feel more enterprise.

What's actually working for people? And more importantly, what doesn't suck to maintain once you've set it up? The last thing I want is to pick something that looks good on day one and then becomes a nightmare six months in.

Also curious if anyone's just gone the route of hosting markdown files in a repo and using GitHub Pages or similar. Seems like it could be fine honestly, just wondering what I'm missing.

Hi, y'all I was searching something to move away from obsidian and due to the content of my notes/documents I can't use obsidian cause of the fact that i need plugins and I just can't realy on a system where components may case information leak of unauthorized access.

In the past I used Gitbook for my study notes and I liked it a lot, the nice presentation of my notes and code block made it awesome for study notes and documentations.

So after all this preface I was searching something to selfhost with:

1. Plain markdown storage, so I can easily export and source controll these files.

2. Secure access to these notes, encryption is not necessary but good if only client side, with no local permeant cache to prevent info leaks from the browser

3. Easy media management: for example copy paste an image will save a copy on the server that will be linked to the markdown note

I know these are a lot of requirements but this will help me a lot. Thanks in advance for any help or tips

Hyperbook is a markdown-based tool for creating interactive workbooks. Similar to Retype or GitBook, it converts markdown into HTML, CSS, and JavaScript while extending markdown syntax to support interactive elements.

Features:

✅ Markdown-Based – Uses markdown for writing and formatting content.

🎨 Interactive Elements – Supports P5.js sketches, ABC music notation, audio, bookmarks, and more.

🔄 Import/Export – Allows saving and restoring workbook states as JSON files.

📱 Responsive Design – Adapts to window resizing, scrolling, and user interactions.

💻 VS Code Integration – Provides an extension for rendering Hyperbook markdown in Visual Studio Code.

🚀 Live Preview – Enables real-time previewing of markdown files.

Currently, it is most used by computer science and mathematics teachers to create dynamic educational materials.

Here are a few public examples:

• Scratch4j: https://scratch4j.openpatch.org/

• Software Challenge: https://docs.software-challenge.de/

• Hyperbook: https://hyperbook.openpatch.org/

• Informatik: https://informatik.openpatch.org/web/grundlagen/html/02-ueberschriften-und-paragraphen

For more details, visit the GitHub repository (https://github.com/openpatch/hyperbook) or check the documentation (https://hyperbook.openpatch.org).

So, I want to use its free tier but it says its for open-source projects???

So non-open source projects are not allowed on gitbook free tier?

We've been using GitBook for like two years and honestly it was solid. Then they announced the pricing change and... yeah, no. We're a small team and suddenly we're looking at costs that don't make sense for what we actually need.

The main thing we care about is that our API docs are easy to navigate, searchable, and don't look like they were made in 2005. Bonus points if it's not a nightmare to set up. We use Stripe's docs as the gold standard tbh.

I've been looking at Readme but haven't actually used it yet. There's also Stoplight which seems fine if you're into the whole visual API design thing, but we just want something that works. And then there's always just... building something ourselves with MkDocs or Sphinx, which feels like overkill for what we need.

Has anyone switched away from GitBook recently? What'd you land on? Curious if people are using the open source stuff or if there's something better that actually costs money but doesn't break the bank.

Also quick question for anyone still on GitBook - did the pricing actually affect you guys or did you negotiate something, because that'd be useful info too.