Wiki.js ile Kurumsal Bilgi Tabanı: IT Dokümantasyonunu Nasıl Yönettim

2022 yılında çalıştığım kurumda bir sistem mühendisi işten ayrıldığında fark ettim: o kişinin yönettiği 3 sunucuya dair tek bir yazılı belge yoktu. O günden sonra tüm IT bilgisini kalıcı hale getirecek bir sistem kurmaya karar verdim.

Neden Wiki.js?

Wiki.js modern, açık kaynaklı bir bilgi yönetim platformu. Confluence, Notion ve SharePoint'e ücretsiz self-hosted alternatif. Markdown ve WYSIWYG editör, LDAP entegrasyonu, Git senkronizasyonu, tam metin arama.

Docker ile Kurulum

version: '3'
services:
  db:
    image: postgres:15
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wiki
      POSTGRES_PASSWORD: güçlü_şifre
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    restart: unless-stopped
  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_NAME: wiki
      DB_USER: wiki
      DB_PASS: güçlü_şifre
    ports:
      - "3000:3000"
    restart: unless-stopped

docker compose up -d

Nginx reverse proxy:

server {
    listen 443 ssl;
    server_name wiki.sirketiniz.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

LDAP / Active Directory Entegrasyonu

Admin panelinde Authentication → LDAP/AD bölümüne gidin. LDAP sunucu adresi, base DN, bind kullanıcısı bilgilerini girin. AD entegrasyonu sonrası kullanıcılar Windows oturum bilgileriyle direkt giriş yapabiliyor.

İzin Sistemi

IT ekibi tüm wiki'ye okuma/yazma yetkisine sahip. Departman yöneticileri kendi bölümlerini düzenleyebiliyor. Çalışanlar kendi departman wiki'sini okuyabiliyor, IT altyapı sayfalarına erişimi yok.

Wiki Yapısı

IT Altyapı: sunucu envanteri, ağ topolojisi, kurulum rehberleri, yedekleme prosedürleri.

Operasyon: kullanıcı yönetimi, VPN rehberi, sık sorulan sorular.

Projeler: tamamlanan projelerin teknik detayları ve değişiklik geçmişi.

Git Senkronizasyonu

Tüm wiki içeriği otomatik Git reposuna push ediliyor. Admin panelinde Storage → Git bölümünü aktif edin. Her kaydetmede değişiklikler otomatik commit ediliyor.

Benimseme Süreci

Wiki kurmak kolay, benimsemesini sağlamak zor. İki şey işe yaradı: sorun çıkınca wiki'deki prosedürü göstermek ve herkesin kendi alanında sayfa yazmasını sağlamak. IT ekibi artık her kurulum sonrası otomatik wiki belgesi açıyor.

Sonuç

İki yılda 340 sayfa, 1.200'den fazla düzenleme birikti. Wiki.js kurumsal bilginin tek kişide hapsolmasını engelliyor. Sorularınız varsa iletişim formundan ulaşabilirsiniz.