Help · version 0.1.13

Connect your devices

Use Add a device for both phones and computers. Your Personal Hub holds the shared archive and runs connected-account imports. Each installed companion keeps its own local copy; signing in to the same account alone does not link independent archives.

Add a phone or computer

  1. On the device already connected to your Hub, open Settings → Devices & Sync → Add a device.
  2. Install the companion app on the other device if needed. Get the companion app for Windows, Android & Linux opens the downloads page.
  3. Scan the QR code with your phone's camera. Android versions with verified app-link support open the invitation in Gravify; otherwise the web page offers Open in Gravify and the companion download. After installing, scan again. You can also scan from an updated Gravify app or choose Use a code instead and enter the backup code.
  4. Check the invitation, choose a recognizable device name and select Connect. Opening the link alone does not authorize a device. Keep Gravify running on your Hub until pairing finishes.

An invitation expires after ten minutes and works once. Creating a new one replaces the previous unused invitation. Keep the QR code and backup code private. If you use an older companion that cannot scan the new web QR, enter the backup code or update it.

The normal invitation supports access across networks through encrypted connections; Gravify signaling and encrypted relay services may help establish or carry the connection. To use your own network instead, follow the next section.

Local or private network

Use Settings → Devices & Sync → Other connection options → Local or private network for Wi-Fi, Ethernet, or an owner-managed VPN. Tailscale is one option; an existing private network works too. Both devices must be able to reach the Hub's HTTPS address, with a certificate the receiving device trusts.

  1. Prepare private HTTPS access to your Hub on your network. Gravify does not install or configure an arbitrary VPN for you. Do not expose an unsecured Hub port to the public internet.
  2. On the Hub, select Add a device over your network, enter its reachable HTTPS address and select Create invitation.
  3. On the other device, scan the invitation in an updated Gravify app or use its backup code. If entering an address manually, open Other connection options, then use the Local or private network fields for the HTTPS address, one-time pairing code and device name.
  4. Select Connect. This invitation connects through the supplied address without Gravify signaling or relay services. It does not replace your existing saved route on another device.

A home LAN alone is not reachable when you leave home. Connect both devices to your private VPN to use this option elsewhere. VPN services may use their own encrypted relays or control services. Your privacy also depends on your devices, network setup and chosen provider.

Optional Tailscale setup on Windows

Tailscale is a separate app that connects your devices through a private encrypted network. You use your own account; Gravify does not ask for your Tailscale password. It is not a backup or a place to store your archive.

  1. Install Tailscale on both devices, sign in and confirm that both appear in your Tailscale devices page. Use the same account or a private network whose access rules permit the connection.
  2. On the Windows Hub, open Settings → Devices & Sync → Other connection options → Local or private network → Check Tailscale.
  3. In the Tailscale DNS settings, enable MagicDNS and HTTPS Certificates if needed. Certificate computer and network names are publicly recorded; choose names without sensitive information. Follow the official HTTPS guide if your controls differ.
  4. In Gravify, choose Enable private access. This prepares a private HTTPS address without replacing another service or a public Funnel route. If setup fails, see Tailscale Serve.
  5. Quit Gravify completely, including its tray controller, and reopen it. Choose Check Tailscale again, then use that HTTPS address with Add a device over your network.

Tailscale may use its own encrypted relays when a direct path is unavailable. This route does not use Gravify's relays.

Connect a device that already has an archive

Open Settings → Devices & Sync → Other connection options → Connect to another computer. Follow the same invitation or private-network flow. Gravify keeps the new connection in a separate local replica; this does not merge independent archives. Restart when instructed to use the connected workspace.

You can use Back to return to Devices & Sync before connecting. During registration and connection saving, wait for the operation to finish before leaving.

Check that it works

Create a test person on one device and check that it appears on the other after synchronization. Edit it there and check the first. Restart the companion and confirm that the same archive returns. For a private VPN, repeat with a device on a different internet connection, such as a phone hotspot.

Keep the Hub awake and running Gravify when synchronizing. Always Ready in Background Activity can keep the Hub available; scheduled low-consumption capture does not keep the full Hub available, and a VPN does not prevent computer sleep. Installed clients keep local work usable offline; changes wait until the Hub is reachable. Media stored on the Hub is fetched when needed rather than copying the entire media archive automatically.

Other controls and troubleshooting

Devices & Sync is available from Settings.

To change which computer hosts your archive, see Move your Personal Hub.