safari.md

title
Use Cockpit with Safari on an iPhone or iPad

Safari's default WebSocket framework on iOS, iPadOS, and ARM-based Macs does not support the WebSocket Secure sessions which Cockpit needs to function when using a self-signed or otherwise invalid certificate, even when they are manually marked as trusted. [Installing a valid certificate]({{ site.baseurl }}/guide/latest/https.html) should resolve this issue.

As an alternative workaround, you can enable Apple's future/experimental WebSocket framework which does work as expected.

iOS and iPadOS

1. Open the Settings app

   

2. Scroll down and tap on "Safari"

    

3. Scroll down to the bottom and tap on "Advanced"

    

4. Tap on "Experimental Features" at the bottom

   

5. Scroll down until you see "NSURLSession WebSocket"

    

6. Enable "NSURLSession WebSocket"

    

7. You're done! Navigate to Cockpit with Safari and sign in normally.

   {:.safari-icon}

macOS on ARM (M1)

1. Open Safari's settings, select "Advanced", and enable "Show Develop menu in menu bar"

   {:.full-width}

2. Go to Safari's "Develop" menu, select "Experimental Features", and enable "NSURLSession WebSocket"

   {:.full-width}

3. You're done! Navigate to Cockpit with Safari and sign in normally.

   {:.safari-icon}