Får jag använda Klokka i mitt företag eller sälja det vidare?

Ja. MIT-licensen tillåter användning, ändringar och kommersiell användning, så länge upphovsrättsmeddelandet och licenstexten följer med koden.

Behöver jag en egen server?

Nej. Tjänsten på klokka.se är gratis att använda. Att köra Klokka själv är ett val, inte ett krav.

Vad behövs för att köra Klokka själv?

API:t, webbappen, PostgreSQL, en Logto-instans för inloggningen och ett SMTP-konto för inbjudningar. Pushnotiser kräver ett Expo-projekt och Firebase. Någon installationsguide finns inte ännu.

Finns det Docker-images?

Repot innehåller en Dockerfile för API:t, webbappen och webbplatsen, så du kan bygga egna images. Färdiga images att hämta publiceras inte i dag.

Hur skiljer sig Klokka från Kimai?

I vem som för in tiden. I Kimai mäter var och en sin egen tid, ofta per projekt. I Klokka för arbetsgivaren in timmarna åt de anställda, som ser samma månad i mobilen.

Tidrapportering med öppen källkod, under MIT-licens

Klokka är tidrapportering med öppen källkod under MIT-licens: arbetsgivaren loggar de anställdas timmar och båda ser samma månad. Tjänsten vi driftar är gratis att använda, utan gräns för antalet anställda, på webben och i Android-appen, på svenska och engelska.

Öppen källkod betyder att du kan läsa varenda rad som hanterar dina anställdas timmar, och att Klokka inte försvinner med ett företag. Koden finns på GitHub, och den version som körs på klokka.se byggs från samma kod.

Vad MIT-licensen betyder

MIT-licensen är en av de mest tillåtande licenserna som finns. Du får använda Klokka, ändra koden och köra den, även i ditt företag eller åt andra. Det enda villkoret är att upphovsrättsmeddelandet och licenstexten följer med när du sprider koden vidare.

Samma kod som tjänsten

Det finns ingen stängd kärna. Allt som tjänsten på klokka.se kör finns i samma repo: API:t, webbappen, Android-appen och den här webbplatsen. Det som inte finns där är våra lösenord och nycklar, som det ska vara.

Vad som finns i repot

Hela Klokka ligger i ett repo, uppdelat i några delar:

API:t, skrivet i Java 25 med Quarkus, med PostgreSQL som databas.
Webbappen i Next.js och Android-appen i Expo (React Native).
Ett gemensamt API-kontrakt i OpenAPI, som både servern och klienterna genereras från.
Inloggning via Logto, och en Dockerfile för API:t, webbappen och webbplatsen.

Kör Klokka själv

Vill du köra Klokka på din egen server behöver du API:t, webbappen, en PostgreSQL-databas, en egen Logto för inloggningen och ett SMTP-konto för inbjudningsmejlen. Pushnotiser till Android-appen kräver dessutom ett eget Expo-projekt och Firebase.

Koden och Dockerfiles finns på GitHub. Någon steg-för-steg-guide för att köra Klokka själv finns inte ännu: README beskriver hur man kör Klokka lokalt för utveckling. För de flesta är den driftade tjänsten enklast, och den är gratis att använda.

Andra verktyg med öppen källkod

Kimai, solidtime och Traggo är bra verktyg med öppen källkod, men de är byggda för att var och en ska mäta sin egen tid, ofta per projekt eller kund, med timer. Klokka är byggt för en arbetsgivare som för in timmarna åt sina anställda, som sedan ser dem.

Licenserna skiljer sig också: Kimai och solidtime har AGPL-3.0, Traggo GPL-3.0 och Klokka MIT.

Bidra

Ärendelistan på GitHub är färdplanen. Hittar du ett fel eller saknar något, skriv ett ärende på GitHub. Pull requests är välkomna, både kod och översättningar: läs CONTRIBUTING.md först. Säkerhetsproblem rapporteras enligt SECURITY.md, inte i ett öppet ärende.

Din data

Vilken månad som helst kan exporteras som en CSV-fil, när du vill, så dina timmar sitter aldrig fast i Klokka. Kör du Klokka själv ligger timmarna i din egen databas. Hur den driftade tjänsten hanterar uppgifterna står i integritetspolicyn, och vem som bygger Klokka på sidan om Klokka.