Samodzielny hosting

Do uruchomienia OpenTickly u siebie wystarczy jeden plik docker-compose.yml. Poniżej opisujemy, jak przejść od zera do działającej instancji.

Wymagania systemoweCopy Anchor Link

• Dowolna maszyna z systemem Linux, macOS lub Windows z zainstalowanym Docker Engine 20.10+ oraz Docker Compose v2
• Około 1 GB pamięci RAM i 1 GB miejsca na dysku
• Jeden wolny port TCP (domyślnie 8080)

Jeśli nie masz jeszcze Dockera, najpierw zainstaluj go według oficjalnej instrukcji.

Wdrożenie serweraCopy Anchor Link

Krok 1 — Pobierz docker-compose.ymlCopy Anchor Link

Utwórz nowy katalog i pobierz plik compose:

mkdir -p opentickly && cd opentickly

wget -O docker-compose.yml \
  https://raw.githubusercontent.com/CorrectRoadH/OpenTickly/main/docker-compose.yml

Uruchamia on trzy kontenery:

• OpenTickly — interfejs webowy + REST API (dostępny na porcie 8080)
• postgres — baza danych (tylko w sieci wewnętrznej, niedostępna z zewnątrz)
• redis — cache i zadania w tle (tylko w sieci wewnętrznej, niedostępny z zewnątrz)

Krok 2 — (opcjonalnie) Skonfiguruj .envCopy Anchor Link

Wartości domyślne działają od razu. Jeśli chcesz zmienić port lub hasła, utwórz w tym samym katalogu plik .env:

# Port, na którym dostępne są Web UI i API
OPENTOGGL_PORT=8080

# Zanim zaczniesz naprawdę korzystać, zmień na silne hasła
OPENTOGGL_POSTGRES_PASSWORD=postgres
OPENTOGGL_REDIS_PASSWORD=opentoggl

To jedyne trzy ustawienia, które możesz zmienić przez .env. Wszystko inne (nazwa bazy, użytkownik, obrazy, dane połączeń) jest celowo wpisane na stałe w pliku compose, żeby instalacje były proste i do siebie podobne. Jeśli chcesz zmienić coś więcej, edytuj bezpośrednio docker-compose.yml.

Krok 3 — Uruchom konteneryCopy Anchor Link

docker compose up -d

Dostęp do aplikacji webowejCopy Anchor Link

Otwórz w przeglądarce http://<twój-IP>:8080, zarejestruj pierwsze konto i możesz zacząć śledzić czas.

Na telefonieCopy Anchor Link

Aplikacji mobilnej jeszcze nie ma, ale możesz dodać aplikację webową do ekranu głównego telefonu i używać jej jak aplikacji (PWA). Rozmawiamy też z twórcami zewnętrznych aplikacji do Toggl, np. Timery, o obsłudze OpenTickly.

Podłączenie agentów AICopy Anchor Link

OpenTickly nie ma limitu 30 zapytań na godzinę znanego z Toggl, więc Claude, Cursor i inni agenci mogą z niego korzystać, ile potrzebują. Skonfiguruj toggl-cli, a po kilku minutach agent będzie za Ciebie włączał i zatrzymywał timer oraz porządkował projekty.

AktualizacjaCopy Anchor Link

docker compose pull
docker compose up -d

Wdrożenie na NAS / HomelabCopy Anchor Link

OpenTickly działa wszędzie tam, gdzie działa Docker Compose. Poniższe kroki to ta sama instalacja, tylko wyklikana w interfejsie danego systemu.

CasaOSCopy Anchor Link

1. Otwórz panel CasaOS
2. Przejdź do App Store → Custom Install → Import docker-compose
3. Wklej zawartość docker-compose.yml
4. Ustaw port Web UI na 8080 i zapisz
5. Uruchom aplikację z panelu

Wejdź pod http://<twój-adres-CasaOS>:8080.

ZimaOSCopy Anchor Link

ZimaOS (oficjalny system Zimablade / Zimacube) korzysta z tego samego App Store co CasaOS, więc kroki są identyczne: App Store → Custom Install → Import docker-compose i wklejasz plik compose.

SynologyCopy Anchor Link

Synology DSM 7.2+ obsługuje Docker Compose poprzez Container Manager:

1. Otwórz Container Manager → Projekt → Utwórz
2. Nadaj nazwę projektu, np. opentickly
3. Wybierz Użyj docker-compose.yml i wklej plik compose
4. Przejdź przez kreator, klikając dalej aż do końca

fnOSCopy Anchor Link

fnOS ma wbudowany panel Dockera:

1. Otwórz aplikację Docker z pulpitu fnOS
2. W lewym panelu wybierz Compose → Nowy projekt
3. Nazwij projekt opentickly, pozostaw domyślną ścieżkę zapisu
4. W polu Zawartość Compose wklej plik compose
5. Kliknij Wdróż i poczekaj, aż wszystkie trzy kontenery zaświecą się na zielono

Inne platformyCopy Anchor Link

Poniższe platformy korzystają z tego samego procesu Docker Compose:

• Unraid — Community Applications lub wtyczka Compose Manager
• TrueNAS SCALE — niestandardowa aplikacja + Docker Compose
• Proxmox LXC — zainstaluj Docker w kontenerze LXC, a następnie postępuj według wdrożenia serwera

Referencja konfiguracjiCopy Anchor Link

Przez .env możesz zmienić trzy ustawienia:

Wszystko inne (nazwa bazy, użytkownik, tagi obrazów, dane połączeń, nazwy wolumenów) jest ustawione bezpośrednio w docker-compose.yml. Jeśli chcesz to zmienić, edytuj ten plik.

Punkty końcowe health checkCopy Anchor Link

Kolejne krokiCopy Anchor Link

• HTTPS i odwrotne proxy
• Kopie zapasowe i aktualizacje
• Integracja z AI — podłącz Claude, Cursora i innych agentów do swojej instancji
• Repozytorium GitHub — kod źródłowy, Issues, Discussions
• Masz problem z instalacją? Daj nam znać w Issues