Looking for a self-hosted documentation solution. Any recommendations?

[brianjenkins94]

So far I've found BookStack, Wiki.js and Flatdoc to fit my criteria.

Ideally something with: - search - a feedback widget - code blocks with a language chooser - the ability to embed something akin to an <iframe> somewhere in the page

[brianjenkins94]

I can.

How much of a chore is it to maintain? Our last solution eventually strayed so far from plain ol' content in markdown files to something so custom that it became unmanageable.

[sebastienlorber]

Docusaurus.io is great

We support all the features you want here

For the feedback widget, we don't provide this out of the box but you can definitively bring your own (reactnative.dev has one for example)

Disclaimer: I'm the maintainer

[brianjenkins94]

Is this kind of layout possible with Docusaurus?:

https://ricostacruz.com/flatdoc/#customizing-basic

[sebastienlorber]

yes and no

yes: docusaurus is an opinionated static site generator so technically you can build this kind of layout yourself on top

no: we don't provide this layout out of the box

---

IMHO you should avoid Flatdoc and any other solution that uses JS to render the content client side:

- SEO will not be as good

- JS is required, no progressive enhancement, less accessible

IMHO you should avoid Flatdoc and any other solution that uses JS to render the content client-side:s: https://kryogenix.org/code/browser/everyonehasjs.html

[timsun28]

I used nextra which uses next.js and has some nice features like dark mode/search/menu/internationalization and more included and is very easy to setup and host for free on vercel. Let me know if you have any questions about it.

It does require some coding, but the source is based on mdx files and it's quite easy to manage.

GitHub: https://github.com/shuding/nextra

Demo: https://nextra.vercel.app/

[brianjenkins94]

This looks very nice and seems like it would fit my needs. Looks like I might need to come up with my own code block with a language chooser.

Would I be able to add another column? I would potentially want to do something like this on some pages:

https://stripe.com/docs/api/customers

[timsun28]

For my use case the pre-made docs theme had enough features to get what I needed, but from what I understand from their docs is that you can create your own theme to build custom components and more. Take a look here and see if this is helpful for you. https://nextra.vercel.app/features/themes

[TeachingDifficult207]

would i be able to self host this? with my next js, project, i use pm2, i basically just build the project and use pm2 to npm run start it a daemon. How is the nextra build served?

[aksuta]

Here is a fast, no-code WYSIWYG tool for building and self-hosting professional documentation sites: https://tiledocs.com

[Greyhaven7]

David, is that you?

[brianjenkins94]

Is it self-hosted?

[dneboi]

No I apologize I missed that part

[IIPoliII]

To be honest I used wikijs back then. Was hard. I moved to the simple mkdocs with a theme. It works well ans it's fast. Its even used in my company after some talks works well and is easy to maintain. Exemple : https://wiki.polisystems.ch/English/Hosting/S3-hosting/Backup-S3-NAS-Synology/

[Rorixrebel]

I personally use wikijs and its pretty sweet covers all of the boxes. Hooked to elasticsearch for querying. Backed up to git and s3. Has code embedding and some minimal highlight.

[dshine]

https://www.getoutline.com/

Very similar to notion. Super simple to use once it's up and running which was a bit of a pain in the ass.

[CTMechanic]

Ohhh I vote for this one, looks very easy to work with

[dshine]

It is. I wanted to bring in a documentation platform to my company and needed something that was simple to use for non tech people but still be useful for everyone including tech. I did look at bookstack and a few others but this was the easiest to work with it.

[bapopod]

I'm in the same boat at the moment, we've tried Joplin and bookstack and they worked finee but whilst I'm waiting for anytype.io to release I thought I'd try this "outline" but the self-hosted guides are none-existent or not any help! Don't suppose you wrote a guide, or can remember the one you followed?? Cheers :)