Last updated: June 29, 2026

Moving KensaSocial to a New Mac

KensaSocial licenses are bound to your machines through Lemon Squeezy device activations. Each license supports up to three active devices at once. When you replace a Mac or move to a new machine, free a slot on the old device before logging in on the new one.

Before you start

• You need your Lemon Squeezy license key (from your purchase receipt or the Lemon Squeezy customer area).
• Your scheduled posts and drafts live in the local SQLite vault (kensa.db) on each machine. They are not synced to the cloud. Copy data/kensa.db from the old Mac if you want to keep that queue history on the new machine.
• OAuth connections (Twitter, LinkedIn, etc.) are tied to your KensaSocial profile, but each new install must reconnect platforms locally after login.

Step 1 — Deactivate the old device in Lemon Squeezy

1. Open the Lemon Squeezy customer area (link in your purchase receipt email, or sign in at app.lemonsqueezy.com).
2. Find your KensaSocial order and open the license details.
3. Under Activations (or Devices), locate the activation for the Mac you are retiring.
4. Deactivate that device to free one slot on your license.

If you no longer have access to the old machine and all three slots are in use, deactivate any machine you no longer need. You must have a free slot before the new Mac can activate.

Step 2 — Install and log in on the new Mac

Install the CLI globally:

npm install -g kensasocial

Activate your license on this machine (same key as before):

kensasocial login <YOUR_LICENSE_KEY>

This registers the new Mac with Lemon Squeezy and stores your local profile in data/kensa.db.

Optional — restore queue data from the old Mac:

# Copy data/kensa.db from the old machine into ~/.kensasocial/data/
# (or your project data/ directory)
# Then run login again if auth_state was not copied with the file.

Register MCP with your IDE and start KensaSocial:

kensasocial install
kensasocial start

Dashboard: http://localhost:3456

Step 3 — Reconnect your platforms

OAuth tokens are not copied from machine to machine. On the new Mac, reconnect each social account:

CLI:

kensasocial connect twitter
kensasocial connect linkedin
# … repeat for each platform you use

Dashboard: open the Accounts tab and click Connect for each platform.

Verify everything with:

kensasocial status

Three-device limit

Need help?

Email [email protected] with your order email, a brief description of the issue, and whether you still have access to the old Mac.