Troubleshooting

The gateway won't start

The gateway’s LineFerry app says Gateway Stopped, or Start Gateway doesn’t stick.

1. Open Magisk → Modules and check LineFerry is installed and switched on. If you just installed it, reboot.
2. Open Magisk → Superuser and check LineFerry is allowed root.
3. Tap Start Gateway again and give it ten seconds.

The iPhone won't connect

The Gateway tab on the iPhone stays on Disconnected or Reconnecting.

• Same network? Both phones must be on the same Wi-Fi, or the iPhone on the gateway’s hotspot.
• Guest network? Many routers stop devices on guest networks from seeing each other. Use the main network.
• Local network permission: iPhone Settings → Privacy & Security → Local Network → LineFerry must be on.
• Tap Auto-Detect Gateway in the Gateway tab to search the network again.

The iPhone doesn't ring

First, open LineFerry and check the Gateway tab says Connected.

• Only when the app is swiped away, and you’re on the hotspot? That’s expected today. See Networks and ringing.
• Focus or Do Not Disturb silences LineFerry calls like any other. Check Control Centre.
• The gateway phone rang instead? The gateway switches to ringing on its own when no iPhone has been reachable for a minute and it’s off Wi-Fi. Open LineFerry on the iPhone and it switches back.

No sound, or one-way sound

• iPhone Settings → LineFerry → Microphone must be on.
• Hang up and call again. If it keeps happening, restart the gateway: Stop Gateway, then Start Gateway.

Texts don't arrive

• Check the gateway itself received the text in its own Messages app.
• Allow notifications for LineFerry on the iPhone.
• Open LineFerry’s Messages tab and pull down to refresh.

Still stuck

Reply to your early-access email with what you tried and roughly when it happened. The gateway keeps a log of recent activity, which helps us find the cause quickly.