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 ni kör det själva. Texten ligger på er egen server och inte hos någon annan, vilket är hela poängen när ni skriver något ni 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 ni 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 ni 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 ni 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 ni 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 ni 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 ni 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 ni 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. Ni behöver se att det faktiskt fungerar innan ni litar på det under ett riktigt möte.

Den vanligaste fällan

Att tro att texten är säker. Startar ni 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 ni bett om det. Raderar ni containern med docker rm ligger volymen faktiskt kvar, men namnlös och svår att hitta igen. Kör docker rm -v om ni vill vara säkra på att allt verkligen är borta, och ge volymen ett namn med -v etherpad_data:/opt/etherpad-lite/var när ni startar om ni vill kunna hitta och återanvända den.

För några veckors mötesanteckningar duger det, förutsatt att ni 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.