Installera Docmost

Vad Docmost är

En wiki för företaget. Ni skriver sidor, lägger dem i utrymmen och hierarkier, och alla ser samma text uppdaterad i samma sekund. Två personer kan skriva i samma dokument samtidigt utan att skriva över varandra.

En wiki är inte ett anteckningsblock. Poängen är att svaret på en fråga skrivs ner en gång, på en plats alla hittar. Var köper vi råvaran? Vad kostade den förra gången? Vem pratar vi med hos leverantören? I ett företag där folk kommer och går är det här skillnaden mellan att veta något och att minnas att någon visste det.

Docmost har sidhistorik, kommentarer i marginalen och en sökfunktion som letar i själva texten. Det går också att dela en enskild sida publikt, vilket är bekvämt när ni vill visa en kund eller samarbetspartner hur ni jobbar utan att ge bort allt.

Det här är ett serverprogram

Docmost körs inte som ett program på datorn. Det behöver tre delar som pratar med varandra: själva Docmost, en databas som heter PostgreSQL, och en snabbminnestjänst som heter Redis. Docker sätter upp alla tre på en gång. Har ni inte Docker, börja med Installera Docker.

Det finns även en betald molnversion från Docmost själva. Vad den kostar står på docmost.com.

Windows och Linux Mint

Samma fil på båda. Skapa en mapp som heter docmost i hemmappen, alltså i C:\Users\ert-namn på Windows och i /home/ert-namn på Linux Mint. Lägg en textfil i mappen som heter compose.yaml:

services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: 'http://localhost:3000'
      APP_SECRET: 'BYT_UT_MIG_1'
      DATABASE_URL: 'postgresql://docmost:BYT_UT_MIG_2@db:5432/docmost'
      REDIS_URL: 'redis://redis:6379'
    ports:
      - "3000:3000"
    volumes:
      - docmost:/app/data/storage
    restart: unless-stopped

  db:
    image: postgres:18
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: BYT_UT_MIG_2
    volumes:
      - db_data:/var/lib/postgresql
    restart: unless-stopped

  redis:
    image: redis:8
    command: ["redis-server", "--appendonly", "yes", "--maxmemory-policy", "noeviction"]
    volumes:
      - redis_data:/data
    restart: unless-stopped

volumes:
  docmost:
  db_data:
  redis_data:

BYT_UT_MIG_1 är en lång slumpsträng, gärna trettio tecken eller mer. På Linux Mint får ni en med openssl rand -base64 32, på Windows fungerar lösenordsgeneratorn i er lösenordshanterare lika bra. BYT_UT_MIG_2 är databasens lösenord och står på två ställen i filen. Båda ska vara exakt samma sträng.

Öppna terminalen och gå in i mappen. På Windows är det PowerShell:

cd $HOME\docmost

På Linux Mint heter programmet Terminal:

cd ~/docmost

Starta sedan:

docker compose up -d

Svarar Docker att ingen compose.yaml hittades står ni i fel mapp, och cd-raden är det som fattas. Vänta sedan någon minut medan databasen sätts upp och öppna http://localhost:3000. Första gången skapar ni arbetsytan och ägarkontot. Vi körde precis den här uppsättningen och kom in utan extra handpåläggning.

En sak att vara klar över innan ni bjuder in någon: localhost pekar alltid på den egna datorn. Wikin finns bara på maskinen där containern körs, och en länk som skickas till en kollega leder till kollegans egen dator. För att skriva de första sidorna och se hur det fungerar räcker det. Ska företaget läsa och skriva samtidigt måste Docmost ligga på en maskin som står på och nås på den maskinens adress. Då ändras också APP_URL, och vad som händer om den raden står fel handlar sista avsnittet om.

Använd företagets gemensamma mejladress till ägarkontot, inte någons privata. Annars hänger hela arbetsytan på en enda person som slutar.

Tre saker att göra först

1. Skapa två utrymmen direkt: ett för det interna, ett för det som får visas utåt. Det är mycket lättare att hålla isär från början än att flytta femtio sidor i mars.
2. Bjud in resten av företaget från inställningarna och sätt rätt roll på varje person. Alla behöver inte kunna radera utrymmen.
3. Skriv den första riktiga sidan innan ni pillar mer på inställningarna. En sida som heter Så gör vi när en beställning kommer in är värd mer än en perfekt struktur utan innehåll.

Den vanligaste fällan

Att sätta APP_URL till fel adress. Docmost bygger sina länkar utifrån den raden, alltså länkar i inbjudningsmejl, delade sidor och det som händer när ni klickar er runt. Står det http://localhost:3000 men företaget når servern på en IP-adress, hamnar alla på sin egen dator i stället för på wikin. Sidan ser ut att fungera för den som satte upp den och för ingen annan.

Rätta det genom att skriva in den adress användarna faktiskt använder, till exempel http://192.168.1.42:3000, och köra docker compose up -d igen. Byter ni APP_SECRET i efterhand loggas däremot alla ut på en gång, så den raden sätter ni en gång och rör sedan inte.