tiko-run/tiko

One canvas for all your work: live tasks from your tracker, arranged the way you think

Website • Docs • Quick start • Roadmap • Discussions

Contents

• What is tiko
• Why tiko
• What you can do
• Install
• Documentation
• Community
• Security
• Contributing
• Activity
• License

What is tiko

tiko is an open-source, self-hosted whiteboard where the tasks from your tracker live as cards. You lay them out the way you think about them, and their statuses update on their own.

It is for people who keep a lot of work in their head: leads, managers, anyone juggling tasks across projects.

Why tiko

Trackers show work as lists and columns. A plan that spans several projects ends up in your head, or on a whiteboard that is out of date the day after you draw it.

tiko puts the same tasks on an infinite canvas and keeps them current. What makes it different:

• Cards are live. Each one shows the task's real status, refreshed while the board is open.
• Your tracker stays in charge. tiko shows tasks as they are in your tracker. Each person connects their own token and sees only what their tracker access allows.
• It is yours. Self-hosted, your data in your own Postgres, no ads or analytics trackers.

Works with Jira Cloud, Jira Data Center and Server, and GitHub issues today. Linear, Plane and others are planned: all trackers.

What you can do

Put live tasks on a board

Add cards by key, link or query, or paste links straight from your tracker tabs. Adding tasks →

Arrange them the way you think

Frames, sticky notes, text and arrows around the cards, with smart guides that snap things into place. The board →

Plan on a timeline

Drop cards onto a Gantt to get bars with live status, stages, milestones and dependency lines. Gantt →

Wait without watching

Put a reminder next to a card. It goes off after a set time or when the task leaves its status. A focus timer with music sits at the top of the screen. Reminders and focus →

Find anything from the keyboard

⌘K searches the board and runs commands, and every tool has a shortcut. Search → · Shortcuts →

Work on a board together

Invite people with a link and give each board viewers and editors. Everyone on a board sees each other's changes as they happen. Working together → · Sharing →

Install

One command

System	Run
Linux, macOS	curl -fsSL https://tiko.run/install.sh | sh
Windows 10, 11 (PowerShell)	irm https://tiko.run/install.ps1 | iex

The installer sets up Docker if it is missing, starts the latest release and prints the address, the username and the password. Options and step-by-step instructions: install guide.

Docker

mkdir tiko && cd tiko
curl -fsSL https://github.com/tiko-run/tiko/releases/latest/download/compose.release.yml -o compose.yaml
docker compose up -d

From source

git clone https://github.com/tiko-run/tiko.git
cd tiko
docker compose up --build

With Docker or from source, open http://localhost:3000 and sign in as admin. The password is in the log: docker compose logs api | grep 'tiko password'. In PowerShell use Select-String in place of grep. Lost the password? See the guide.

Cloud

tiko Cloud is tiko hosted by us, with nothing to install and a free plan. Coming soon.

Or deploy your own copy:

Platform	Deploy
Railway
Render
DigitalOcean	Coming soon

After the deploy sign in as admin. The password is generated for you: it is the TIKO_PASSWORD variable of the api service on Railway, or of tiko-api on Render. Costs and limits of each platform are in the quick start.

A fresh install opens on a sample board with demo tasks, so you can try everything before you connect your tracker.

Documentation

Everything else lives at docs.tiko.run.

Get started	Install · Quick start
Use tiko	Adding tasks · Working together · Search · Gantt · Reminders and focus · Shortcuts
Trackers	Supported trackers · Connect Jira Data Center
Self-host	Configuration · Data, backups and upgrades · Updates · Security and privacy
Project	Roadmap · Architecture · Changelog

Community

• Ideas, questions and feature requests go to Discussions.
• Found a bug? Open an issue.
• What we build next is in the roadmap.

Security

• Every page and API route asks you to sign in.
• Tracker tokens are encrypted on the server and never sent back to the browser or written to logs.
• tiko does not track people. It talks to your tracker, to GitHub to check for a new release, and once a day sends a few usage counts with no personal data. Each can be turned off; the fields are listed in Usage stats.

Details: Security and privacy. Report vulnerabilities privately, as described in SECURITY.md.

Contributing

Bug reports, ideas and pull requests are welcome, and a new tracker provider is a good first contribution. Start with CONTRIBUTING.md and the architecture overview. On your first pull request a bot asks you to sign the CLA with one comment, once. Everyone follows the Code of Conduct.

Activity

If tiko is useful to you, star the repo. It helps other people find it.

License

GNU AGPL v3 (AGPL-3.0-only) © The tiko Authors. Use, self-host and modify tiko for free, privately or inside a company. If you let people use a changed version over a network, offer them its source under the same license.

The name and logo are covered by TRADEMARKS.md, third-party components are listed in THIRD_PARTY.md. For other terms, such as embedding tiko in a closed product, email [email protected]. Releases up to and including v2026.10.6 were published under the MIT License and stay available under it.