Skip to main content

BookStack - An open-source wiki based on the “bookshelf” concept 📚

"BookStack istis einea moderne,modern, open‑open-source Wiki‑/Dokumentationsplattform,wiki/documentation dieplatform Wissenthat bewusstdeliberately organizes knowledge nichtnot alsas losea Seitensammlungloose organisiert,collection sondernof inpages, einerbut sehrusing intuitivena Metapher:very intuitive metaphor: Regale (Shelves)Shelves, BĂŒcher (Books)Books, KapitelChapters, (Chapters) undand Seiten (Pages)Pages. GenauThis diesestructure Strukturis machtexactly what makes BookStack fĂŒr viele Teams so attraktivappealing –to besondersmany dann,teams—especially wennwhen Inhaltecontent needs to remain verstĂ€ndlichclearly gegliedertorganized undand leichteasy auffindbarto find bleiben sollen..

Technisch basiertTechnically, BookStack aufis dembuilt on the PHP‑FrameworkLaravel LaravelPHP framework undand wirdis unterreleased derunder the MIT‑LizenzMIT License. veröffentlicht.It Esruns lĂ€uft plattformunabhĂ€ngigplatform-independently (typisch:typically: Linux‑Server,Linux VMserver, oderVM, Container)or undcontainer) istand can be used mehrsprachigmultilingually nutzbar..


WarumWhy BookStack? ✹

VieleMany Wikiswikis sindare extremextremely flexibelflexible—but –that aberfreedom geradeoften dieseleads Freiheitto fĂŒhrt oft zu Wildwuchs.sprawl. BookStack verfolgttakes einena etwasslightly anderendifferent Ansatz:approach:

  • KlareClear Informationsarchitekturinformation architecture stattinstead endloserof Kategorienendless undcategories Namenskonventionenand naming conventions
  • SchnellerQuick Einstiegonboarding fĂŒrfor Nicht‑Techniker:innennon-technical users (the UI undand Bedienlogikinteraction sindlogic „selbsterklĂ€rend“are “self-explanatory”)
  • Team‑tauglichTeam-ready durchthrough Rollen,roles, Rechtepermissions, undand nachvollziehbaretraceable Änderungenchanges

Kurz:In short: BookStack istis besondersespecially stark,strong wennwhen ihryou einwant to cleanly structure an internesinternal Nachschlagewerk, eine Team‑Dokumentationreference, ProzesshandbĂŒcherteam documentation oder, Projektwissenprocess manuals, sauberor strukturierenproject wollt.knowledge.


EinordnungContext & GeschichteHistory đŸ•°ïž

BookStack wurdewas started in 2015 vonby Dan Brown gestartet(not the novelist, but an English web developer). Early on, the project briefly had a different name (nicht der Romanautor, sondern ein englischer Webentwickler). In der FrĂŒhphase trug das Projekt kurzzeitig einen anderen Namen („Oxbow““Oxbow”), wurdebut aberit schnellwas inquickly renamed to BookStack. umbenannt.Over Überthe dieyears Jahreit reiftematured escontinuously—including kontinuierlichmajor –UI inklusive grĂ¶ĂŸerer UI‑Verbesserungenimprovements (u. a.among fĂŒrother things for mobile Nutzung)use)—and –after unda verließlong nachdevelopment lĂ€ngererperiod Entwicklungit schließlicheventually dieleft Beta‑Phase.the beta phase.

Heute giltToday, BookStack alsis einesconsidered derone bekanntestenof the best-known PHP‑basiertenPHP-based Wiki‑Projektewiki projects imin Open‑Source‑Umfeld,the mitopen-source aktiverspace, Communitywith undan regelmĂ€ĂŸigemactive Release‑Zyklus.community and a regular release cycle.


Kernkonzept:Core InhalteConcept: Content in vierFour EbenenLevels đŸ§±

DieThe Strukturstructure istis bewusstintentionally begrenztlimited—and –that’s unda das ist eine StĂ€rke:strength:

  1. Regale (Shelves)Shelves
    • dienenserve alsas ĂŒbergeordnetea Sammlunghigher-level collection (z. B. „IT“e.g., „HR“,“IT,” „Produktion““HR,” “Production”)
  2. BĂŒcher (Books)Books
    • thematischethematic Einheitenunits (z. B. „Onboarding“e.g., „Runbooks“,“Onboarding,” „Sicherheitsrichtlinien““Runbooks,” “Security Policies”)
  3. Kapitel (Chapters)Chapters (optional)
    • zusĂ€tzlicheadditional Gliederungstructure innerhalbwithin einesa Buchesbook
  4. Seiten (Pages)Pages
    • derthe eigentlicheactual Content:content: Anleitungen,guides, Standards,standards, FAQs, Checklistenchecklists, usw.etc.

PraktischAlso ist auch:practical: BĂŒcherBooks könnencan inbe mehrerenplaced Regalenon liegenmultiple shelves—helpful –when hilfreich,content wennshould Inhaltebe mehrerenassigned Bereichento zugeordnetmultiple werdenareas sollen,without ohneduplicating sie zu duplizieren.it.


Bearbeiten:Editing: WYSIWYG undand Markdown ✍

BookStack bietettypically typischerweiseoffers zweitwo Arbeitsweisen:ways of working:

  • WYSIWYG‑EditorWYSIWYG editor fĂŒrfor schnelle,quick, visuellevisual Bearbeitungediting (ideal fĂŒrfor vielemany Teams)teams)
  • Markdown‑EditorMarkdown editor inklusiveincluding Live‑Vorschaulive fĂŒrpreview Menschen,for diepeople lieberwho „textbasiert“prefer schreibenwriting “text-based”

DazuOn kommentop Funktionen,of diethat, imthere Alltagare vielfeatures Zeitthat sparen:save a lot of time in day-to-day work:

  • Versions-/RevisionshistorieVersion/revision history (Änderungentrack nachvollziehenchanges undand beiroll Bedarfback zurĂŒckrollen)if needed)
  • Medien-/BildverwaltungMedia/image management
  • DirektlinksDirect links zuto konkretenspecific AbsĂ€tzenparagraphs (praktischuseful fĂŒrfor Supportsupport undand Diskussionen)discussions)
  • VolltextsucheFull-text search ĂŒberacross BĂŒcher,books, Kapitelchapters, undand Seitenpages

OrganisationOrganization & Rechte:Permissions: gemachtBuilt fĂŒrfor Teams đŸ‘„đŸ”’

EinA großermajor Pluspunktadvantage istis dasthe Rollen-roles undand Berechtigungssystempermissions system. DamitIt lĂ€sstallows sich sehrvery granular steuern,control werover waswho darfcan –do zumwhat—for Beispiel:example:

  • Inhalte nur lesenread-only vs. bearbeitenedit
  • bestimmterestrict BĂŒcher/Regalecertain nurbooks/shelves fĂŒrto einzelnespecific Gruppengroups
  • Aktionenlimit wieactions Löschen,such Exportierenas oderdeleting, Rechteverwaltungexporting, einschrĂ€nkenor managing permissions

DasThis machtmakes BookStack sowohlinteresting fĂŒrfor both kleinesmall Teamsteams als auch fĂŒrand grĂ¶ĂŸerelarger Organisationenorganizations interessant,that diewant „ein“a Wikiwiki fĂŒrfor alle“everyone” wollen,without ohnelosing dabei die Kontrolle zu verlieren.control.


AuthentifizierungAuthentication & SSO‑AnbindungSSO Integration 🔑

NebenIn klassischemaddition Loginto perclassic login via E‑Mail/Passwortemail/password kann, BookStack can (jedepending nachon Setup)the auchsetup) inbe bestehendeintegrated Unternehmensumgebungeninto integriertexisting werden,corporate z. B.environments, ĂŒber:e.g., via:

  • LDAP/Directory‑Anbindungdirectory integration
  • SSO‑naheSSO-like Verfahrenmethods bzw.or externeexternal Providerproviders (typisch:typically: OAuth/OIDC‑basierteOIDC-based Logins,logins, jedepending nachon Konfiguration)configuration)

DamitThis lĂ€sstoften sichlets BookStack hĂ€ufigfit gutwell ininto vorhandeneexisting IdentitĂ€tslandschaftenidentity einpassenlandscapes—an –important eincriterion wichtigesfor Kriteriuman fĂŒr“enterprise „Enterprise‑Feeling“feel” ohnewithout Enterprise‑Lizenzkosten.enterprise license costs.


Installation: klassischTraditional oderor pervia Docker 🐳

FĂŒrTo denrun Betriebit, werdenyou ĂŒblicherweisetypically benötigt:need:

  • PHP (Laravel‑Stack)Laravel stack)
  • MySQL/MariaDB
  • WebserverWeb server (z. B.e.g., Nginx/Apache)
  • optional Git (Updates)updates) undand Composer

VieleMany installierenpeople install BookStack heutetoday direktdirectly alsas a Docker‑ContainerDocker container, weilbecause dasit Setupmakes damitthe reproduzierbarsetup undreproducible Updatesand oftupdates einfacherare sindoften – besonderseasier—especially in Homelabs,homelabs, KMU‑SetupsSMB odersetups, beior Self‑Hosting‑Fans.among self-hosting enthusiasts.


Erweiterbarkeit:Extensibility: ohneNo Plugin‑Plugin Chaos, aberStill trotzdem flexibelFlexible đŸ§©

BookStack hatdoes keinnot klassischeshave „Plugin‑Ökosystem“a wieclassic manche“plugin andereecosystem” Systeme.like Stattdessensome setztother essystems. aufInstead, kontrollierteit Erweiterungsmöglichkeiten,relies u. a.:on controlled extension options, including:

  • REST‑REST API fĂŒrfor Automatisierungautomation undand Integrationenintegrations (CRUD aufon Kernobjekte)core objects)
  • Theme‑SystemeTheme systems (visuellvisual undand logisch),logical) umto OberflĂ€checustomize undthe Verhalteninterface anzupassenand behavior
  • Möglichkeiten,Options to embed Customcustom Code/code/HTML einzubettenand undinfluence Editor‑Verhalteneditor zu beeinflussenbehavior

DasAt wirktfirst zunĂ€chstthis wenigermay „App‑Store‑artig“,seem istless aber“app-store-like,” fĂŒrbut vielemany Adminsadmins angenehm:appreciate it: wenigerless Wildwuchssprawl, wenigerfewer InkompatibilitĂ€ten,incompatibilities, dafĂŒrand klarereclearer Upgrade‑Pfade.upgrade paths.


TypischeTypical EinsatzszenarienUse Cases ✅

BookStack funktioniertworks besondersparticularly gutwell fĂŒr:for:

  • InterneInternal Wissensdatenbankenknowledge bases (IT‑Howtos,IT how-tos, SOPs, Troubleshooting)troubleshooting)
  • Onboarding‑DokumentationOnboarding documentation („So“How arbeitenwe wirwork hier“here”)
  • Projekt‑Project undand Produktdokumentationproduct documentation
  • QualitĂ€tsmanagementQuality management / Prozessdokusprocess documentation
  • Team‑HandbĂŒcherTeam handbooks mitwith sauberer,a wiederverwendbarerclean, Strukturreusable structure

FazitConclusion 🎯

BookStack istis eina sehrvery zugĂ€ngliches,accessible, strukturiertesstructured Wiki,wiki dasthat auffocuses on Ordnung,order, Bedienbarkeitusability, undand Team‑FunktionalitĂ€tteam functionality. setzt.If Weryou’re einlooking Systemfor sucht,a dassystem nichtthat erstdoesn’t durchbecome jahrelangeusable Konventionenonly undafter AufrĂ€umprojekteyears nutzbarof wird,conventions findetand hiercleanup oftprojects, eineyou’ll ĂŒberzeugendeoften Lösung:find a compelling solution here: klarclearly gegliedertstructured, guthighly durchsuchbarsearchable, rechtefĂ€higpermission-capable, Self‑Hosting‑freundlichself-hosting-friendly—and –pleasantly und dabei angenehm „unaufgeregt““no-drama” in dereveryday tĂ€glichen Nutzung.use."