Installera och testa
Takt är Docker Compose: en färdig app-image, Postgres och fillagring. Med internet hämtas images från Docker Hub. Airgapped: spara dem på en dator med nät, ladda dem här och starta utan pull. Den här sidan tar er genom installationen, det första kontot och vad ni kan prova när ni är inne.
Demo — inte för produktion. Den här installationen är till för att prova Takt på en laptop eller i en avgränsad pilot. Kör den inte i produktion än.
En laptop räcker för att prova. Samma stack skalar till era egna servrar bakom en reverse proxy.
Docker Desktop 4.30+ (Mac, Windows) eller Docker Engine 27+
(Linux). docker compose version
ska visa v2.x. Gamla
docker-compose med bindestreck
fungerar inte.
Postgres, fillagring och appen. amd64
och arm64; Apple Silicon fungerar.
Online: images från Docker Hub första gången. Airgapped:
docker load, sedan
docker compose --env-file .env up -d --pull never.
Byt port i .env om 3005 är
upptagen.
Ingen annan installerare. AI är frivilligt: mejla takt@fennister.com för en demo-nyckel. Allt annat fungerar utan.
Snabb kontroll att Docker är igång:
docker --version
docker compose versionSex steg. De tre första i terminalen, resten i webbläsaren. Inget sparas förrän ni är klara med installationsguiden.
Ladda ner takt-deploy-<version>.zip
från
senaste releasen.
Den innehåller Compose-filer, skript och en färdig
.env — ingen källkod. Packa upp
och gå in i mappen:
unzip takt-deploy-*.zip
cd takt-deploy
ls -a
# .env .env.example README.md backup-loop.sh pg-migrate-data-dir.sh cli/ compose.yaml down.sh
.env är dold i Finder och
Utforskaren; ls -a visar den.
Vilken version av appen ni får styrs av
TAKT_VERSION i den filen. Låt den
stå.
.env (frivilligt)
Öppna .env i en editor innan
första starten. Allt kan stå kvar som det är; de här raderna
är de som brukar ändras:
| Rad | Värde | Varför |
|---|---|---|
AUTH_SECRET= |
utdata från openssl rand -base64 32 |
Obligatorisk. Unik per installation. Ändra den aldrig senare, annars loggas alla ut. |
AI_ENABLED=1 |
1 |
Slår på Takt-agenten i hela installationen. Utan den är AI dold överallt, även om en organisation slår på den. |
AI_GATEWAY_API_KEY= |
demo-nyckel från Takt |
Krävs tillsammans med AI_ENABLED.
Mejla
takt@fennister.com
för en demo-nyckel. Klistra in direkt efter
=, utan citattecken. Dela
den inte vidare.
|
TAKT_PORT och
AUTH_URL
|
t.ex. 3006 och http://localhost:3006 |
Bara om 3005 är upptagen. Båda måste peka på samma port, annars fungerar inte inloggningen. |
Sätt AUTH_SECRET före Compose.
Tom hemlighet: Compose startar inte. Vill ni köra utan AI?
Lämna de två AI-raderna tomma — allt utom agenten
fungerar. Bara demo-nycklar; detta är ingen
produktions-gateway.
Samma stack. TAKT_VERSION i
.env är Hub-taggen
utan v.
Images: mrweiland/takt:<version>,
postgres:19beta3-alpine,
chrislusf/seaweedfs:4.46.
docker compose --env-file .env up -d
Hämtar de tre images från Docker Hub om de saknas, startar
stacken och migrerar. Första nedladdningen tar någon minut.
AUTH_SECRET måste redan vara
ifylld.
På en dator med internet, samma version som
i zippens .env:
docker pull mrweiland/takt:<version>
docker pull postgres:19beta3-alpine
docker pull chrislusf/seaweedfs:4.46
docker save mrweiland/takt:<version> postgres:19beta3-alpine chrislusf/seaweedfs:4.46 \
| gzip > takt-images.tar.gz
Flytta zippen och takt-images.tar.gz
till den luftgapade maskinen. Där:
gunzip -c takt-images.tar.gz | docker load
unzip takt-deploy-*.zip
cd takt-deploy
docker compose --env-file .env up -d --pull never
--pull never pratar inte med Hub.
Zippens ./cli/install.sh använder
den medföljande binären (ingen GitHub-nedladdning).
Klart när alla fyra rader visar
healthy eller
Up:
takt-install-app-1 Up (healthy) 0.0.0.0:3005->3005/tcp
takt-install-backup-1 Up
takt-install-postgres-1 Up (healthy)
takt-install-s3-1 Up (healthy)
Öppna sedan
http://localhost:3005/register.
Online: kör
docker compose --env-file .env up -d
igen för att starta (och hämta imagen för er
TAKT_VERSION om den saknas).
Airgapped: docker load av ny tar,
sedan
docker compose --env-file .env up -d --pull never.
Databasen ligger kvar i en Docker-volym mellan omstarter.
På /register: namn (1–80 tecken),
e-post (används som inloggning) och ett lösenord på minst 8
tecken. Klicka Skapa konto. Ni loggas in
direkt och hamnar i installationsguiden. Första kontot blir
administratör för organisationen ni skapar i nästa steg.
Gränssnittet följer webbläsarens språk. Tvinga svenska med
/sv först i adressen, t.ex.
http://localhost:3005/sv/register;
engelska med /en.
Fyra korta skärmar på /app/new.
Inget sparas förrän ni klickar
Skapa arbetsyta i slutet, så ni kan gå fram
och tillbaka.
localhost:3005/app/<adress>.
Fylls i från namnet. Små bokstäver, siffror och bindestreck,
2–40 tecken.
AI_ENABLED
och en demo-nyckel från
takt@fennister.com
i .env.
Visar hur användare loggar in i den här installationen: e-post och lösenord, plus Fortsätt med Microsoft när Entra ID är konfigurerat (se nedan). Inget att välja.
/app/<adress>/teams/plattform.
/register.
Läs igenom och klicka Skapa arbetsyta →. Ni
landar på teamets tavla:
http://localhost:3005/app/<adress>/teams/<team>.
På teamets tavla eller backlogg: Nytt → välj typ (epic, feature, story, task, bug, krav) → ge det en titel, det enda obligatoriska fältet → spara. Det dyker upp i första kolumnen. Följ sedan rundturen nedan.
Bjud in kollegor: organisationsmenyn → Inställningar → Medlemmar. Rollerna är Organisationsadmin (allt, inklusive inställningar, medlemmar och säkerhetskopior), Medlem (skapa och redigera arbete i sina team) och Läsare (bara läsa). Rollen aktiveras när personen loggar in med samma e-postadress.
En guidad rundtur, en funktion i taget. Varje kort tar några
minuter. Sökvägarna är relativa
/app/<adress>.
Flytta ett kort mellan kolumner. Öppna backloggen och växla flikarna Epics / Features / Stories — samma arbete på tre höjder. Fäll ut en feature och se dess stories.
/teams/<team> · /teams/<team>/backlogÖppna sidopanelen på backloggen och dra en rad till en sprint, ett initiativ eller ett mål. Kopplingen sparas på arbetsobjektet — det är den kartan ritar senare.
/teams/<team>/backlogSkapa en sprint, planera in en story och öppna sprinttavlan. Dra tasks mellan stand-up-fälten, filtrera på person, växla till tabellvyn.
/teams/<team>/sprintLägg till ett mål och ett initiativ som stöder det. Betygsätt en idé på värde, insats och risk. Öppna sedan Kartan och se bilden ritad från kopplingarna ni just gjorde.
/goals · /initiatives · /ideas · /map
Skapa en leverans — ett projekt eller en tjänst — med egen
nyckel, tavla och backlogg. Bocka för teamen som arbetar i den.
Arbetsnycklar ser ut som PAW-12.
Lägg till organisationsetiketter i inställningarna, teametiketter på teamet. Sätt en på ett arbetsobjekt och filtrera tavlan på den.
/settings?tab=labelsMed en demo-nyckel från takt@fennister.com: tryck ⌘ J (eller Ctrl J) för att öppna agentpanelen. Välj en skill som Förbättra beskrivningen, eller be den bryta ner en feature i stories. Varje ändring är ett förslag ni godkänner.
/settings?tab=ai för tak och förbrukningStatus visar live-kontroller av databas, filer, AI och backuper. Säkerhetskopior listar de Postgres-dumpar Compose tar var 30:e minut (48 senaste sparas). Återställning ersätter hela installationen — var försiktig i test.
/status · /backupBåda är tillägg till en installation som redan kör. Hoppa över dem vid en första titt.
Ett kommando efter az login
registrerar en single-tenant-app och skriver de tre variabler
Takt behöver. Kräver Azure CLI. Rollerna stannar i Takt; ingen
SAML, ingen katalogläsning.
az login
./entra-oidc.sh --auth-url "$AUTH_URL" --write .env
docker compose --env-file .env up -d
Sedan visas Fortsätt med Microsoft på
/login. Inloggningen gäller hela
installationen, inte per organisation. Användare med e-post och
lösenord kan dessutom slå på en autentiseringsapp under
Konto.
takt är ett terminalkommando som
pratar med er installation via API:et, och en MCP-server för
Cursor, Claude Desktop och andra klienter. macOS och Linux.
Zippen innehåller redan binären;
./cli/install.sh kopierar den
lokalt (fungerar airgapped).
./cli/install.sh
takt login --url http://localhost:3005
takt # interaktiv session
takt --help
MCP-konfiguration: { "command": "takt", "args": ["mcp"] }.
Ingen token i filen — den kommer från
takt login.
Körs från mappen takt-deploy.
docker compose --env-file .env up -d # online: starta / hämta om den saknas
docker compose --env-file .env up -d --pull never # airgapped: lokala images
docker compose --env-file .env down # stoppa Takt, behåll data
docker compose --env-file .env ps # status
docker compose --env-file .env logs -f app # appens logg
Uppdatera: packa upp den nya zippen i samma mapp (behåll
.env), höj
TAKT_VERSION, sedan
up -d igen. Airgapped: ny
takt-images.tar.gz på en dator med
nät, docker load, sedan
up -d --pull never.
Börja om från noll — raderar all data i den här installationen och ber er bekräfta:
./down.sh --purge
docker compose --env-file .env up -d # airgapped: lägg till --pull never| Container | Image | Roll |
|---|---|---|
takt-install-app-1 |
mrweiland/takt:<version> |
Appen, på TAKT_PORT |
takt-install-postgres-1 |
postgres:19beta3-alpine |
Databas, bara nåbar inifrån Docker |
takt-install-s3-1 |
chrislusf/seaweedfs:4.46 |
Fillagring för bilder och bilagor |
takt-install-backup-1 |
postgres:19beta3-alpine |
Dump var 30:e minut till backupvolymen |
Bara TAKT_PORT exponeras på er dator.
All data ligger i Docker-volymer som heter
takt-install-* och överlever omstarter
och uppgraderingar.
| Symptom | Åtgärd |
|---|---|
docker compose version kör inte |
Docker är inte igång. Starta Docker Desktop och försök igen. |
manifest for mrweiland/takt:<version> not found |
TAKT_VERSION i .env
finns inte på Docker Hub. Använd den utan
v (0.2.0, inte
v0.2.0). Airgapped: imagen
måste redan finnas lokalt efter docker load.
|
pull access denied / unauthorized / Hub nås inte |
Airgapped: docker load först,
sedan docker compose --env-file .env up -d --pull never.
Online: Docker Hub kräver ingen inloggning. Kör
docker logout och försök igen;
kontrollera proxy och brandvägg.
|
| Inloggningen loopar, eller ”Untrusted host” |
AUTH_URL matchar inte adressen i
webbläsaren (port eller host). Rätta och kör
docker compose --env-file .env up -d igen.
|
port is already allocated på 3005 |
Byt TAKT_PORT och AUTH_URL tillsammans. |
| AI är på i organisationen men syns inte |
AI_ENABLED=1 och
AI_GATEWAY_API_KEY saknas i
.env. Be
takt@fennister.com
om en demo-nyckel, lägg till båda raderna och kör
docker compose --env-file .env up -d.
|
Appen står i health: starting |
Normalt upp till en minut första gången (migreringar).
Kolla logs app om det tar
längre.
|
Fastnat? Skriv till
takt@fennister.com och
bifoga utskriften från
docker compose --env-file .env logs app --tail 100.