# OpenTickly

> Compatible with the Toggl API. Your data stays yours.

OpenTickly is an open-source Toggl alternative: 100% Toggl API-compatible, one-command Docker self-hosting, your data stays yours. No seat limits — free for individuals and teams.

## Key Facts

- Website: https://opentoggl.com/
- Live demo: https://track.opentoggl.com
- Repository: https://github.com/CorrectRoadH/OpenTickly
- License: AGPL-3.0
- Install: `docker compose up -d` (Go backend, React frontend, PostgreSQL)
- API compatibility: Toggl Track v9, Reports v3, Webhooks v1
- Platforms: CasaOS, Synology, fnOS, any Docker host
- Pricing: free and open source, no seat limits, no premium tier

## Features

- **Drop-in compatible** — Works with the Toggl API. Your existing tools and integrations carry over.
- **Deploy in minutes** — One docker compose command. Runs on CasaOS, Synology, fnOS.
- **Free & open source** — No seat limits, no tiers. Self-hosted and hosted are the same product.

## FAQ

### Can it replace Toggl Track?

Yes. OpenTickly is compatible with Toggl's Track, Reports, and Webhooks APIs. If your tools talk to Toggl via its API, they should work with OpenTickly without changes.

### Can I bring my Toggl data?

Yes. You can import Toggl export files — your history comes with you.

### What do I need to self-host?

Docker. One docker compose up -d brings up the full stack (Go backend, React frontend, PostgreSQL). We also have guides for Synology, CasaOS, and fnOS.

### Are hosted and self-hosted the same?

Yes. Same code, same features. No premium tier, no feature gating.

### Why AI-friendly?

Stable API, solid docs, self-hostable. Agents and scripts can integrate without third-party rate limits getting in the way.

## Documentation

- https://opentoggl.com/docs
- https://opentoggl.com/docs/getting-started
- https://opentoggl.com/docs/migrate-from-toggl
- https://opentoggl.com/docs/api-compatibility
- https://opentoggl.com/docs/admin-email-sso
- https://opentoggl.com/docs/self-hosting
- https://opentoggl.com/docs/ai-integration

# OpenTickly Documentation

- [What Is OpenTickly](/docs): OpenTickly open-source docs — quickstart, Docker self-hosting, Toggl API compatibility notes, and AI agent integration. From install to wiring up Claude and Cursor, in one reference.
- [Getting Started with OpenTickly](/docs/getting-started): Start tracking time with OpenTickly: try the hosted demo or self-host with Docker, create your first workspace, run a timer, and review the result.
- [Migrate from Toggl to OpenTickly](/docs/migrate-from-toggl): Move Toggl Track data to OpenTickly with an account export archive and detailed time-entry CSV files, then validate workspaces, projects, tags, members, and report totals.
- [Toggl API Compatibility](/docs/api-compatibility): Connect Toggl-compatible tools to OpenTickly using the Track v9, Reports v3, and Webhooks v1 base URLs, API-token authentication, and a practical verification checklist.
- [Configure SMTP Email and SAML SSO](/docs/admin-email-sso): Configure outgoing SMTP email, email verification, invitations, password resets, and workspace SAML 2.0 single sign-on for a self-hosted OpenTickly instance.
- [Self-Hosting](/docs/self-hosting): Deploy OpenTickly on your own machine — Docker Compose brings up Web + API + Postgres + Redis in one command, online in 5 minutes. 100% Toggl API compatible, works with the official clients out of the box.
- [AI Integration](/docs/ai-integration): Let Claude, Cursor, and other AI agents auto-track time, start and stop timers, and manage projects and tags through toggl-cli and installable skill packs. Open-source time tracking built for AI workflows.
- [Practices & Workflow](/docs/practices): How I actually use OpenTickly.
- [Changelog](/docs/changelog): OpenTickly release history — features shipped, fixes, and breaking changes. Tracks the public GitHub releases so AI assistants and humans can see how the project evolves over time.