iOS Setup

Set up Broski on your iPhone or iPad.

Requirements

Requirement	Minimum	Recommended
iOS Version	15.0	17.0+
Device	iPhone 8, iPad (6th gen)	iPhone 12+, iPad (9th gen)+
Storage	50 MB	100 MB

Supported Devices

Broski supports all iPhones and iPads running iOS 15.0 or later. This includes iPhone 8 and newer, and iPad (6th generation) and newer.

Download from App Store

Coming soon on the App Store

iOS app is in development • launching ASAP

Required Permissions

Broski requests only the permissions it needs to function. Here's what each one is for:

Permission	Purpose	Required
Camera	Scan QR code to connect to your system	Yes
Local Network	Connect to bridge server on your local WiFi	Yes
Notifications	Alert when AI needs approval or tasks complete	Optional
Photos	Attach images to your AI conversations	Optional

Local Network Permission

If you deny the Local Network permission, you won't be able to connect to your system over WiFi. You can still use Tailscale for remote connections.

Granting Permissions Later

If you accidentally denied a permission, you can grant it from Settings:

Open Settings
Scroll down and tap Broski
Toggle on the permissions you need

First Launch Walkthrough

Welcome Screen

You'll see a brief intro explaining what Broski does. Tap "Get Started" to continue.

Camera Permission

Broski will ask for camera access. Tap "Allow" to enable QR code scanning.

Local Network Permission

iOS will ask to allow Broski to find devices on your network. Tap "Allow" to connect to your system.

Scan QR Code

Point your camera at the QR code displayed in your terminal. Make sure the bridge is running.

Connected!

You'll see your projects and can start chatting with your AI assistant.

Tailscale Setup (Optional)

For remote access outside your home network, install Tailscale on your iPhone:

Install Tailscale

Download Tailscale from the App Store.

Open Tailscale and sign in with the same account you use on your system.

Enable VPN

Tap "Connect" and allow Tailscale to add a VPN configuration.

Verify Connection

In Broski, your system should now be reachable via its Tailscale IP (100.x.x.x).

Always-On VPN

Enable "Connect on demand" in Tailscale settings to automatically connect when needed. This ensures Broski works even when you're away from home.

iOS-Specific Issues

Camera Permission Denied

Go to Settings > Privacy & Security > Camera, find Broski, and enable camera access.

Local Network Permission Denied

Go to Settings > Privacy & Security > Local Network, find Broski, and enable local network access. You may need to restart the app.

Connection Drops in Background

iOS may suspend background apps to save battery. Keep Broski in the foreground during active sessions, or enable notifications to be alerted when AI needs attention.

QR Code Not Scanning

Try these steps:

Increase terminal brightness/contrast
Hold phone 6-12 inches from screen
Clean your camera lens
Tap "Enter manually" and type the IP address

Next Steps

Remote Access →

Set up Tailscale for access from anywhere

Troubleshooting →

Solutions to common connection issues