Njia mbadala za Notion za kujiendesha (self-hosted)

Jibu fupi

Njia mbadala za Notion zinazojiendesha (self-hosted) zimegawanyika katika makundi matatu, na kuchagua ile inayofaa kunategemea zaidi sehemu ya Notion unayotumia. Ikiwa unataka muonekano wa Notion, wenye kurasa ndani ya kurasa na mwonekano wa database, tumia AppFlowy. Ikiwa unataka wiki ya timu yenye kasi na utafutaji bora, tumia Outline. Ikiwa unataka njia ya haraka zaidi kutoka kwa seva mpya hadi kufikia workspace inayofanya kazi, tumia Docmost.

Zana nyingine mbili hujitokeza mara kwa mara katika utafutaji huu na zote ni majibu sahihi kwa swali tofauti. BookStack ndiyo chaguo bora wakati unachohitaji hasa ni nyaraka zilizopangwa vizuri. Obsidian ndiyo chaguo bora wakati workspace ina mwanachama mmoja tu: wewe mwenyewe.

Jinsi ulinganisho huu ulivyofanywa

Huu ni ulinganisho wa uwezo uliothibitishwa, uliotolewa kutoka kwenye nyaraka rasmi za kila mradi, sampuli ya mazingira iliyochapishwa, na faili yake ya compose ya umma, iliyokaguliwa mnamo Julai 2026. Hii si ripoti ya mwaka mmoja wa matumizi ya uzalishaji kwa kila moja. Pale ambapo kikomo kinatajwa hapa chini, kinatoka kwenye nyaraka za mradi wenyewe au hazina yake, na mwongozo huu unaeleza chanzo chake. Hili ni muhimu, kwa sababu muhtasari mwingi wa aina hii hubuni kimyakimya sehemu ambazo hawakuzikagua.

Mhimili minne hapa chini ndiyo watu huulizia zaidi, kwa mpangilio wanaouliza: database na mwonekano wa jedwali, ushirikiano wa wakati halisi, ufikiaji wa simu, na uzito wa hosting.

AppFlowy: mbadala wa karibu zaidi wa Notion, wenye sharti la leseni

AppFlowy ndio mradi pekee hapa unaonakili mfumo wa data wa Notion kwa umakini. Kurasa, mbao (boards), gridi na mwonekano wa kalenda vyote vipo, programu za desktop na simu ni za asili (native), na muundo wa local-first unamaanisha kuwa programu huendelea kufanya kazi hata seva ikiwa haipatikani.

Self-hosting inahusisha kufanya git clone na kutumia compose file:

git clone https://github.com/AppFlowy-IO/AppFlowy-Cloud
cd AppFlowy-Cloud
cp deploy.env .env
docker compose up -d

Hariri .env kabla ya amri hiyo ya mwisho. FQDN na SCHEME huweka anwani ya umma, na GOTRUE_ADMIN_EMAIL pamoja na GOTRUE_ADMIN_PASSWORD huweka akaunti ya kwanza ya admin. Kuacha GOTRUE_ADMIN_PASSWORD=password kama ilivyo kutatengeneza seva ya umma yenye login ya admin inayoweza kukisiwa kwa urahisi.

Hapa ndipo penye sharti, na hii ndiyo sehemu muhimu zaidi katika makala hii. AppFlowy Cloud imehamia kwenye mtindo wa open-core, na README ya AppFlowy Cloud inaeleza kuwa toleo la bure (Free tier) la self-hosted hutoa "One user seat (per instance)" pamoja na hadi wageni watatu wa kuhariri (guest editors) kwenye kurasa unazoshiriki. Kwa hivyo, toleo ambalo watu wengi hulimaanisha wanaposema "self-hosted Notion" ni, katika ngazi ya bure, nafasi ya kazi ya mtu binafsi yenye wageni wachache. Toleo la kulipia la self-hosted huondoa vikwazo hivi. Kagua ngazi za sasa za bei kabla ya kupanga kuitumia kwa timu ya watu kumi.

Muhtasari: utafutaji bora, ikiwa tayari unatumia single sign-on

Outline inatoa uzoefu bora zaidi wa uandishi na usomaji kati ya programu zote za aina hii. Utafutaji wake ni wa haraka na hupata matokeo sahihi, kihariri chake ni tulivu, na muundo wake unategemea makusanyo na hati zilizopangwa ndani ya nyingine badala ya injini ya hifadhidata. Timu zinazoandika sana mara nyingi hubaki na Outline.

Outline inahitaji PostgreSQL na Redis, na programu husikiliza kwenye port 3000. Siri mbili (secrets) zinahitajika, na faili ya sampuli ya mazingira inakuonyesha kikamilifu jinsi ya kuzitengeneza:

openssl rand -hex 32   # SECRET_KEY
openssl rand -hex 32   # UTILS_SECRET

Kisha weka URL kwenye anwani yako ya umma ya HTTPS, DATABASE_URL, na REDIS_URL. Jambo moja linalowashangaza watu ni uthibitishaji (authentication). Outline haina mfumo wa ndani wa kuingia kwa jina la mtumiaji na nenosiri. .env.sample yake yenyewe inasema kuhusu vitambulisho vya kuingia vya watu wengine kwamba "angalau MOJA kati ya hizi inahitajika kwa usakinishaji unaofanya kazi au hutakuwa na chaguo la kuingia". Google, Microsoft Entra, Slack, Discord na mtoa huduma wa kawaida wa OpenID Connect (OIDC) ndizo chaguo zinazoungwa mkono.

Hiyo ni gharama ya kweli. Ikiwa huna mtoa huduma wa utambulisho (identity provider), kujihudumia Outline kunamaanisha kujihudumia huduma nyingine ya ziada kabla ya Outline kuwa tayari kutumika. Ikiwa tayari unatumia mmoja, hii ni faida, na Outline huenda ndiyo jibu lako.

Docmost: chaguo la haraka zaidi kusanidi

Docmost ndiyo mpya zaidi kati ya hizo tatu na inahitaji kazi ndogo zaidi ili kuanza kufanya kazi. Ina uwezo wa kuhariri kwa ushirikiano wa wakati halisi, miti ya kurasa, nafasi, maoni, na akaunti za barua pepe na nenosiri zilizojengewa ndani, kwa hivyo hakuna mtoa huduma wa utambulisho (identity provider) wa kushughulikia kwanza.

Ukurasa rasmi wa usakinishaji unatoa amri nne:

mkdir docmost
cd docmost
curl -O https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml
openssl rand -hex 32

Weka kamba hiyo ya hex katika APP_SECRET ndani ya faili ya compose, weka APP_URL kwenye anwani utakayotumia kweli, badilisha STRONG_DB_PASSWORD katika sehemu zote mbili inapoonekana, kisha uianzishe:

docker compose up -d
docker compose ps

Kila huduma inapaswa kusoma running. Fungua anwani hiyo kwenye kivinjari na utapaswa kupata ukurasa wa usanidi wa Docmost, ambapo utaunda nafasi ya kazi ya kwanza na mtumiaji wa kwanza wa admin. Stack hii inajumuisha Docmost, PostgreSQL na Redis, na nyaraka zinaweka kiwango cha chini cha 2 vCPU na 4 GB ya RAM.

Onyo moja linalostahili kurudiwa kutoka kwenye nyaraka: kihariri kinatumia WebSockets. Nyuma ya reverse proxy ambayo haipitishi WebSocket upgrade headers, ukurasa hupakia lakini mabadiliko kutoka kwa kivinjari cha pili hayaonekani, bila kosa lolote kuonyeshwa kwa mtumiaji yeyote. Ikiwa unamalizia TLS mbele yake, reverse proxy ya Traefik inayoshughulikia programu kadhaa kwenye seva moja hushughulikia uboreshaji huo kwa usahihi kulingana na usanidi chaguo-msingi.

BookStack: wakati unapotaka nyaraka, si nafasi ya kazi

BookStack hupanga maudhui kama rafu, vitabu, sura na kurasa. Uongozi huo uliopangwa ndio msingi wenyewe. Hakuna anayehitaji kubuni muundo, na baada ya mwaka mmoja wiki bado inabaki kuwa rahisi kutumika. Ina ruhusa thabiti, kihariri kizuri, na ni ya kawaida kwa njia ambayo nyaraka za miundombinu zinapaswa kuwa.

Kitu ambacho haina ni mwonekano wa hifadhidata au uhariri wa mtindo wa vizuizi, kwa hivyo si mbadala wa Notion kwa njia ile ile kama zile tatu za kwanza. BookStack inahitaji PHP 8.2 au mpya zaidi na MySQL 8.0 au MariaDB 10.6 au mpya zaidi. Mradi huu hauchapishi picha yake ya Docker na badala yake unaelekeza kwenye picha za jamii, ambapo inayotumika zaidi ni ile ya LinuxServer.io:

docker pull lscr.io/linuxserver/bookstack:latest

Kwa sababu picha hiyo inatunzwa na jamii, funga toleo badala ya kufuatilia latest, na usome nyaraka za picha hiyo yenyewe kwa ajili ya vigezo vyake vinavyohitajika.

Obsidian: si programu ya seva, na ndiyo hoja yenyewe

Obsidian huhifadhi faili za kawaida za Markdown kwenye folda katika mashine yako. Hakuna seva, kwa hivyo hakuna cha kujiendeshea (self-host) na hakuna kitakachoharibika saa 9 za usiku. Kwa mtu mmoja anayeandika madokezo, inashinda kila chaguo lililotajwa hapo juu kwa kasi na kwa uhakika kwamba faili zako zitadumu muda mrefu zaidi kuliko programu yenyewe.

Sync ndiyo sehemu unayoiendesha mwenyewe. Chaguo zilizopo ni huduma ya kulipia ya kampuni yenyewe, mfumo wa CouchDB unaoendesha plugin ya jamii ya LiveSync, au usawazishaji wa faili za kawaida kama Syncthing au WebDAV share. Uhariri wa wakati halisi kwa watu wengi haupo kwenye orodha hii, kwa hivyo ikiwa watu wawili wanahitaji ukurasa uleule kwa wakati mmoja, Obsidian si zana sahihi.

Hifadhidata na majedwali: mahali ambapo njia mbadala nyingi huishia

Hii ndiyo nguzo inayoamua utafutaji. Watu wanaokosa Notion mara nyingi hukosa hifadhidata: jedwali lenye sehemu zenye aina maalum, mitazamo kadhaa juu ya safu mlalo zilezile, na vichujio.

AppFlowy inayo hii, ikiwa na mitazamo ya grid, board na calendar. Outline, Docmost na BookStack hazina. Zina nyaraka zinazoweza kuwa na majedwali rahisi, jambo ambalo si sawa, kwa sababu safu mlalo hizo haziwezi kutafutwa (queryable) na hakuna mtazamo wa pili juu yake. Ikiwa hifadhidata ya Notion ndiyo inayoshikilia kazi yako, AppFlowy ndiyo chaguo lako pekee la kweli katika kundi hili, na unapaswa kupima kikomo cha watumiaji wa toleo lake la bure dhidi ya ukubwa wa timu yako kabla ya kuamua kuitumia.

Uzito wa hosting: kile kila stack inachokiendesha kwa uhalisia

Docmost na Outline zote huendesha container tatu: programu yenyewe, PostgreSQL, na Redis. Zote hufanya kazi vizuri kwenye VPS ndogo. BookStack huendesha programu hiyo pamoja na database ya MySQL au MariaDB, ambayo ndiyo nyepesi zaidi kati ya hizo nne.

AppFlowy Cloud ndiyo nzito zaidi kwa mbali. Faili lake la compose lililochapishwa huleta nginx, MinIO kwa ajili ya kuhifadhi vitu (object storage), PostgreSQL yenye extension ya pgvector, Redis, GoTrue kwa ajili ya uthibitishaji (authentication), huduma ya AppFlowy Cloud yenyewe, frontend ya admin, worker, huduma ya utafutaji (search service), huduma ya AI, na web app. Hiyo ni database halisi, hifadhi ya vitu, na takriban container kumi. Panga bajeti ya kumbukumbu (memory) ipasavyo, na usome jinsi huduma, volumes, na networks za Docker Compose zinavyounganishwa kabla ya kuanza kuhariri faili hilo.

Ni ipi unayopaswa kuchagua

Mtu mmoja, kwa ajili ya madokezo na rasimu, bila kuhitaji seva: Obsidian, ukitumia mfumo wako wa kusawazisha (sync).

Mtu mmoja au kikundi kidogo kinachohitaji database za mtindo wa Notion: AppFlowy, baada ya kuhakiki kwanza kikomo cha watumiaji kwenye tier ya bure.

Timu inayotengeneza maandishi mengi na tayari inatumia Google Workspace, Entra au mtoa huduma wa OIDC: Outline.

Timu inayotaka nafasi ya kazi ya pamoja inayoweza kuanza kufanya kazi mchana huu bila mtoa huduma wa utambulisho (identity provider): Docmost.

Nyaraka za miundombinu au bidhaa ambazo watu wengi husoma na wachache huhariri: BookStack.

Nini kinaharibika baada ya usakinishaji

Hitilafu tatu ndizo sababu kuu za nyuzi nyingi za usaidizi katika miradi hii, na zote tatu ni masuala ya usanidi badala ya hitilafu za programu (bugs).

Ya kwanza ni URL ya programu. Docmost APP_URL na Outline URL lazima ziwe anwani inayotumiwa kikweli na kivinjari, ikijumuisha https://. Ikiwekwa kuwa localhost na programu kuwekwa nyuma ya domain, maelekezo ya kuingia (login redirects) yatawapeleka watumiaji kwenye mashine ambayo si yao.

Ya pili ni WebSockets, iliyoelezwa hapo juu. Uhariri wa pamoja (collaborative editing) huacha kufanya kazi kimyakimya wakati programu inaonekana kuwa katika hali nzuri.

Ya tatu ni nakala za akiba (backups). Programu hizi zote huhifadhi maudhui yake katika PostgreSQL au MySQL, si katika faili unazoweza kuziona, kwa hivyo kunakili saraka ya volume ya database inayofanya kazi si nakala ya akiba unayoweza kuitegemea. Fanya dump ya database kulingana na ratiba na uhifadhi dump hiyo nje ya seva, kwa njia ile ile ambayo nakala za akiba zilizosimbwa kwa njia ya restic hushughulikia huduma nyingine yoyote yenye hali (stateful service). Unapochagua nini kingine cha kuendesha sambamba nayo, orodha pana ya programu zinazofaa kujihostia mwaka huu ni njia muhimu ya kupima kiasi cha mzigo ambacho seva moja inapaswa kubeba.

FAQ

Ni mbadala gani wa Notion unaojiendesha (self-hosted) unaofanana zaidi na Notion yenyewe?

AppFlowy. Hii ndiyo pekee kati ya miradi hii yenye dhana halisi ya database, ikimaanisha sehemu zenye aina maalum (typed fields) zenye mionekano ya grid, board na kalenda kwa safu zilezile. Outline, Docmost na BookStack ni zana za nyaraka zenye mpangilio wa kurasa. Ni bora kwa nyaraka lakini hazichukui nafasi ya database ya Notion.

Je, ninaweza kujiendeshea (self-host) Notion yenyewe?

Hapana. Notion ni bidhaa ya kibiashara inayohudumiwa na kampuni husika, haina toleo la kujiendeshea na hakuna sehemu ya seva iliyochapishwa kwa ajili hiyo. Kila chaguo katika mwongozo huu ni mradi huru wa chanzo wazi (open source) unaoshughulikia sehemu ya kile ambacho Notion hufanya. Uhamiaji ni mchakato wa kusafirisha na kuingiza data, si kuhamisha programu ileile.

Je, zana hizi zina programu za simu?

AppFlowy inatoa programu asilia za iOS na Android zinazowasiliana na seva yako mara tu unapozielekeza kwenye instance yako. Outline na Docmost hutumiwa kupitia kivinjari cha simu, na zote zinafaa kwa njia hiyo kwa ajili ya kusoma na kuhariri kidogo. Obsidian ina programu kamili za simu, ingawa wewe ndiye unayesimamia usawazishaji (sync). BookStack ni programu ya wavuti inayojirekebisha (responsive) na haina programu ya simu kutoka kwa watengenezaji wake.

Ninahitaji RAM kiasi gani kwenye VPS?

Docmost inaelekeza kiwango cha chini cha 2 vCPU na 4 GB ya RAM, na Outline pamoja na BookStack ziko katika kiwango kinachofanana kwa timu ndogo. AppFlowy Cloud ni ubaguzi, kwa sababu faili yake ya compose huanza na huduma takriban kumi ikiwemo PostgreSQL yenye pgvector na hifadhi ya vitu (object storage) ya MinIO, kwa hivyo panga kuwa na kumbukumbu na diski zaidi hapo.

Je, Outline inaweza kutumika bila kuingia (sign-in) kupitia Google au Microsoft?

Ndiyo, lakini si bila mtoa huduma wa utambulisho (identity provider). Outline inasaidia mtoa huduma wa kawaida wa OpenID Connect sambamba na wale waliotajwa, kwa hivyo seva ya OIDC inayojiendeshea inafanya kazi. Kile ambacho haikubali ni jina la mtumiaji na nenosiri la kawaida la ndani, na sampuli ya mazingira yake inaeleza kuwa angalau mtoa huduma mmoja wa tatu lazima asanidiwe, vinginevyo usakinishaji hautakuwa na chaguo za kuingia.