Kota · Guide

Get started

Kota keeps folders in sync between your computers and the people you share them with. You need an account (sign in with email or Nostr) and the small kota program on each computer. No server or programming tools needed.

1. Sign in

Sign in or sign up The same step: your account is made the first time.

2. Install kota on your computer

macOS and Linux

Open Terminal and paste:

curl -fsSL https://kota.atlantislabs.space/install.sh | sh

Windows

Open PowerShell (Start menu, type “PowerShell”) and paste:

irm https://kota.atlantislabs.space/install.ps1 | iex
Or download the program yourself

Downloaded by a browser, macOS asks before running it (right-click, Open) and Windows may warn that it is unknown; the commands above avoid that. On macOS and Linux, make it executable: chmod +x kota-*.

3. Add this computer to your account

kota login

Your browser opens Kota and asks “Add device …?”. Check the code matches and approve. The device keeps its own key; nothing else to type.

4. Start syncing

kota install

Kota now syncs in the background and starts again at every login. Your files are in Kota in your home folder: users/ for people's folders (yours too), groups/ for groups.

kota status shows how it's going; kota pause and kota resume stop and restart it. Everything else (where the folder is, names, removing a device) is on the Devices page.

Share

On the website, open a folder and press Share: add people (they need to have signed in once) or a group, as readers or editors. Their computers get the folder at the same place in their own Kota folder.