Sync your own devices through iCloud

Each workspace gets its own private store in your iCloud account. Your files stay in an ordinary local folder, and nokko keeps a copy in that store. There is no account to make and no server to run.

Only you can see it. The store belongs to your Apple Account, and nokko has no way to share it. To work with someone else, use GitHub or your own server.

It carries the same files as the other options, and it uses your iCloud storage. nokko syncs a couple of seconds after each change, and every 30 seconds.

1. 1Open the workspace and choose Workspace ▸ Put Workspace on iCloud….
2. 2Read the sheet, then click Put on iCloud. It counts the files as they go.

To start from nothing, choose Workspace ▸ New Workspace…, select In iCloud and click Start Fresh in iCloud…. You pick a folder, nokko adds the starter files, and the same sheet opens.

1. 1Check that the Mac is signed in to the same Apple Account.
2. 2Choose Workspace ▸ Join from iCloud….
3. 3Click Download beside the workspace.

The list shows only workspaces in the signed-in account. If it is empty, nothing has been put on iCloud from this account.

1. 1Open Settings and tap Join a Workspace…, then iCloud.
2. 2The first time, type a name under Name This iPhone.
3. 3Tap the workspace under On iCloud. Copying starts straight away.

A workspace already here reads On this iPhone. The same screen can send the open workspace up, with Put “Name” on iCloud, if it is not shared yet. Never use it on a workspace you stopped sharing.

To start one on the phone, tap New Workspace… in Settings, type a name, leave Keep it in iCloud on and tap Create. This needs a subscription or purchase; joining does not. Then use Join from iCloud… on the Mac.

A workspace belongs to the Apple Account that put it on iCloud. If a device signs in to a different account, nokko stops syncing that workspace. It does this so an empty store is not read as everything being deleted, and so your files are not copied into someone else's iCloud.

• On the Mac, the footer reads The server's identity changed. For iCloud that means another account is signed in, and clicking it does nothing.
• On iPhone, Settings shows Sign in again, with a note that the account is no longer signed in.

Your local files are safe. Sign back in to the first account, and syncing resumes after you press the sync button or make a change.

Your edits are always saved on the device first, so none of these lose work. The message shows in the Mac's sidebar footer, and under Sync in the iPhone's Settings, where the row reads Needs attention. When offline, the iPhone row reads Offline. The sync button below means the one in the footer, or Sync Now on iPhone.

On iPhone, open Settings and tap Stop Sharing on This iPhone. The files stay on the phone. The iCloud copy and your other devices are not touched. Do not then use Put “Name” on iCloud on that workspace. nokko keeps its old sync records on the phone, so the upload stops with an error, and in a workspace of a few files it can move them to nokko's trash.

On the Mac, this version has no command for it. Settings ▸ General offers no Forget option for an iCloud workspace. To stop one Mac syncing, do this by hand:

1. 1Press the sync button and wait for Synced just now.
2. 2Choose Workspace ▸ Reveal Workspace in Finder.
3. 3Quit nokko.
4. 4Open the workspace folder and press ⌘⇧. to show hidden files.
5. 5Open the .nokko folder and move its remote folder to the Trash.
6. 6Open nokko. The workspace is now local to this Mac.

This is what Forget does for the other two options. Your boards, and the rest of .nokko, stay. For a server, Forget also deletes the saved password or key, which any other workspace on the same login was using. Putting this workspace on iCloud again makes a second, separate copy with the same name. Your other devices stay on the old one until you stop syncing there and join the new one.

Remove from Nokko… in Workspace ▸ Manage Workspaces… only stops listing the folder. It keeps the connection, so adding the folder back resumes syncing.

The copy in iCloud stays until you delete nokko's data in Apple's iCloud storage settings. That removes every nokko workspace in the account, so other devices then show the deleted message above.

iCloud Drive is a folder that Apple keeps in step for you. If you open a workspace from there, or from Dropbox, Google Drive or OneDrive, the Mac shows this warning once per workspace:

This folder is synced by iCloud Drive. Files can be replaced underneath Nokko or evicted to placeholders, and the service's own conflict copies will appear as extra boards. Sharing through GitHub or SFTP is the supported path; a local folder is the safe one.

The warning is about the folder, not your iCloud account. iCloud Drive can swap a whole file while nokko has it open, sometimes for an older copy from another Mac. It can also replace a file with a placeholder that reads as empty. nokko cannot fix that from inside the folder.

The warning does not name nokko's own iCloud option, but that option is supported. It sits on an ordinary local folder, so none of this applies. To change over, move the workspace out of iCloud Drive to a local folder, open it there, and use Workspace ▸ Put Workspace on iCloud….