SShareShiftby Cameron Shields
Documentation

Docs

Getting started
Sign in with Microsoft once as a Global Administrator; ShareShift registers its worker app, certificate and permissions in your tenant and verifies the connection.
Licensing and workers
How licences, workers and leases work; what happens offline; how to add workers or move to a new tenant.
Teams migration
What Graph can and cannot carry across: standard channels, history, members, private channels, reactions.
Control plane and data handling
Exactly what the licence server stores, and what it never stores.

Getting started

Install ShareShift on a machine you own, enter your licence key from the portal, and open Connections. Press Sign in with Microsoft and sign in with a Global Administrator account for the tenant. ShareShift registers an app named ShareShift Worker in that tenant, creates a certificate whose private key never leaves the machine, sets the application permissions, grants admin consent and waits until Microsoft's tokens carry every permission. About three minutes; nothing in your content is read.

Prefer to do it by hand, or not a Global Administrator? Set up step by step walks through the certificate, the app registration, the IDs and a live permission test, and prints a consent link to send to an administrator. The command line has the same flow as shareshift connect. The full guide, including every permission and why it is needed, is in docs/SETUP.md.

Licensing and workers

A licence is a key like SS-XXXX-XXXX-XXXX-XXXX. Each machine running ShareShift registers as a worker and holds a 15-minute lease that its heartbeat renews. When the licensed number of workers is reached, a new machine is refused until one releases its lease or goes quiet for 15 minutes.

If our licence server is unreachable, workers keep working for three days from their last successful contact, and in-flight packages always finish. Cancelling or revoking stops new packages within 15 minutes.

Monthly and Annual plans are bound to one destination organisation and can be moved to another once per billing month from the portal. MSP plans have client organisation slots instead.