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:
KlareClearInformationsarchitekturinformation architecturestattinsteadendloserofKategorienendlessundcategoriesNamenskonventionenand naming conventionsSchnellerQuickEinstiegonboardingfürforNicht‑Techniker:innennon-technical users (the UIundandBedienlogikinteractionsindlogic„selbsterklärend“are “self-explanatory”)Team‑tauglichTeam-readydurchthroughRollen,roles,Rechtepermissions,undandnachvollziehbaretraceableÄ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:
Regale (Shelves)ShelvesdienenservealsasübergeordneteaSammlunghigher-level collection (z. B. „IT“e.g.,„HR“,“IT,”„Produktion““HR,” “Production”)
Bücher (Books)BooksthematischethematicEinheitenunits (z. B. „Onboarding“e.g.,„Runbooks“,“Onboarding,”„Sicherheitsrichtlinien““Runbooks,” “Security Policies”)
Kapitel (Chapters)Chapters (optional)zusätzlicheadditionalGliederungstructureinnerhalbwithineinesaBuchesbook
Seiten (Pages)PagesdertheeigentlicheactualContent: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 editorfürforschnelle,quick,visuellevisualBearbeitungediting (idealfürforvielemanyTeams)teams)Markdown‑EditorMarkdown editorinklusiveincludingLive‑VorschaulivefürpreviewMenschen,fordiepeoplelieberwho„textbasiert“preferschreibenwriting “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 (ÄnderungentracknachvollziehenchangesundandbeirollBedarfbackzurückrollen)if needed)Medien-/BildverwaltungMedia/image managementDirektlinksDirect linkszutokonkretenspecificAbsätzenparagraphs (praktischusefulfürforSupportsupportundandDiskussionen)discussions)VolltextsucheFull-text searchüberacrossBücher,books,Kapitelchapters,undandSeitenpages
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.bearbeiteneditbestimmterestrictBücher/Regalecertainnurbooks/shelvesfürtoeinzelnespecificGruppengroupsAktionenlimitwieactionsLöschen,suchExportierenasoderdeleting,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-likeVerfahrenmethodsbzw.orexterneexternalProviderproviders (typisch:typically: OAuth/OIDC‑basierteOIDC-basedLogins,logins,jedependingnachonKonfiguration)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 APIfürforAutomatisierungautomationundandIntegrationenintegrations (CRUDaufonKernobjekte)core objects)Theme‑SystemeTheme systems (visuellvisualundandlogisch),logical)umtoOberflächecustomizeundtheVerhalteninterfaceanzupassenand behaviorMöglichkeiten,Options to embedCustomcustomCode/code/HTMLeinzubettenandundinfluenceEditor‑Verhalteneditorzu 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:
InterneInternalWissensdatenbankenknowledge bases (IT‑Howtos,IT how-tos, SOPs,Troubleshooting)troubleshooting)Onboarding‑DokumentationOnboarding documentation („So“Howarbeitenwewirworkhier“here”)Projekt‑ProjectundandProduktdokumentationproduct documentationQualitätsmanagementQuality management /Prozessdokusprocess documentationTeam‑HandbücherTeam handbooksmitwithsauberer,awiederverwendbarerclean,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."