Installera Etherpad

Vad Etherpad är

Ett tomt textfönster i webbläsaren där flera personer skriver samtidigt och ser varandras bokstäver dyka upp. Varje deltagare får en egen färg, så det syns vem som skrev vad. Ingen inloggning, inget konto: den som har länken är med.

Det låter som Google Dokument, och skillnaden är att du kör det själv. Texten ligger på din egen server och inte hos någon annan, vilket är hela poängen när du skriver något du inte vill lägga i en molntjänst.

Etherpad är inte ett program för att göra snygga dokument. Det är ett program för att få ner text fort, tillsammans: mötesanteckningar, idélistor, manus till en video, den där texten till hemsidan som tre personer har åsikter om. Är den färdig kopierar du den vidare till det verktyg som ska formatera den.

Det här är ett serverprogram

Till skillnad från ett ritprogram installeras Etherpad inte med en installationsfil. Det körs i Docker, vilket betyder att programmet ligger i ett färdigt paket som startas med ett kommando. Har du inte Docker ännu, börja med guiden Installera Docker och kom tillbaka hit.

Windows och Linux Mint

Kommandot är detsamma på båda. På Windows skriver du det i PowerShell med Docker Desktop igång, på Mint i Terminal.

docker run -d --name etherpad -p 9001:9001 etherpad/etherpad

Första gången laddas paketet ner, vilket tar några minuter. Sedan öppnar du http://localhost:9001 i webbläsaren och ser Etherpads startsida. Vi har kört exakt det här kommandot, och Etherpad startade direkt med den senaste versionen som fanns då.

Ska kollegorna kunna ansluta räcker det inte med localhost, eftersom det ordet betyder den här datorn. Då behöver de datorns adress på nätverket i stället, och är du på kontorets nät kan brandväggen stoppa det. Det är en sak att prova på förhand och inte fem minuter före mötet.

Tre saker att göra först

1. Skapa en pad med ett namn du kommer ihåg i stället för det slumpade förslaget. Adressen blir då /p/vecka38 och går att skriva in för hand.
2. Klicka på tidslinjeikonen uppe till höger och dra i reglaget. Etherpad sparar varje ändring, alltså kan du spola tillbaka till hur texten såg ut i förrgår.
3. Be någon öppna samma länk på en annan dator och skriv samtidigt i en minut. Du behöver se att det faktiskt fungerar innan du litar på det under ett riktigt möte.

Den vanligaste fällan

Att tro att texten är säker. Startar du Etherpad med kommandot ovan använder programmet en enkel inbyggd databas som heter DirtyDB, och Etherpad säger det själv i loggen: den är inte rekommenderad för skarp drift. Datan ligger i en Docker-volym som skapas automatiskt utan att du bett om det. Raderar du containern med docker rm ligger volymen faktiskt kvar, men namnlös och svår att hitta igen. Kör docker rm -v om du vill vara säker på att allt verkligen är borta, och ge volymen ett namn med -v etherpad_data:/opt/etherpad-lite/var när du startar om du vill kunna hitta och återanvända den.

För några veckors mötesanteckningar duger det, förutsatt att du vet om det. Ska Etherpad leva på lång sikt, lägg till en riktig databas och en volym så att texten ligger utanför containern. Projektets egen compose-fil på GitHub visar hur det ser ut med Postgres.

Och kom ihåg det första stycket: den som har länken är med. Skicka inte länken vidare till en pad där det står saker som inte ska spridas.