Skip to content

Commit 50d5eb9

Browse files
EdwardAngertEdwardAngert
committed
move reorg troubleshooting
1 parent 63adfa5 commit 50d5eb9

File tree

1 file changed

+8
-38
lines changed

1 file changed

+8
-38
lines changed

‎docs/user-guides/desktop/desktop-connect-sync.md

Lines changed: 8 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -88,19 +88,17 @@ You can hover your mouse over the status for the list of conflicts:
8888

8989
If you encounter a synchronization conflict, delete the conflicting file that contains changes you don't want to keep.
9090

91-
## Accessing web apps in a secure browser context
91+
## Troubleshooting
92+
93+
### Accessing web apps in a secure browser context
9294

9395
Some web applications require a [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts) to function correctly.
9496
A browser typically considers an origin secure if the connection is to `localhost`, or over `HTTPS`.
9597

96-
As Coder Connect uses its own hostnames and does not provide TLS to the browser, Google Chrome and Firefox will not allow any web APIs that require a secure context.
97-
98-
> [!NOTE]
99-
> Despite the browser showing an insecure connection without `HTTPS`, the underlying tunnel is encrypted with WireGuard in the same fashion as other Coder workspace connections (e.g. `coder port-forward`).
100-
101-
If you require secure context web APIs, you will need to mark the workspace hostnames as secure in your browser settings.
98+
Because Coder Connect uses its own hostnames and does not provide TLS to the browser, Google Chrome and Firefox will not allow any web APIs that require a secure context.
99+
Even though the browser displays a warning about an insecure connection without `HTTPS`, the underlying tunnel is encrypted with WireGuard in the same fashion as other Coder workspace connections (e.g. `coder port-forward`).
102100

103-
We are planning some changes to Coder Desktop that will make accessing secure context web apps easier. Stay tuned for updates.
101+
<details><summary>If you require secure context web APIs, identify the workspace hostnames as secure in your browser settings.</summary>
104102

105103
<div class="tabs">
106104

@@ -142,34 +140,6 @@ We are planning some changes to Coder Desktop that will make accessing secure co
142140

143141
</div>
144142

145-
## Troubleshooting
146-
147-
### Mac: Issues updating Coder Desktop
148-
149-
> No workspaces!
150-
151-
And
152-
153-
> Internal Error: The VPN must be started with the app open during first-time setup.
143+
</details>
154144

155-
Due to an issue with the way Coder Desktop works with the macOS [interprocess communication mechanism](https://developer.apple.com/documentation/xpc)(XPC) system network extension, core Desktop functionality can break when you upgrade the application.
156-
157-
<div class="tabs">
158-
159-
The resolution depends on which version of macOS you use:
160-
161-
### macOS <=14
162-
163-
1. Delete the application from `/Applications`.
164-
1. Restart your device.
165-
166-
### macOS 15+
167-
168-
1. Open **System Settings**
169-
1. Select **General**
170-
1. Select **Login Items & Extensions**
171-
1. Scroll down, and select the **ⓘ** for **Network Extensions**
172-
1. Select the **...** next to Coder Desktop, then **Delete Extension**, and follow the prompts.
173-
1. Re-open Coder Desktop and follow the prompts to reinstall the network extension.
174-
175-
</div>
145+
We are planning some changes to Coder Desktop that will make accessing secure context web apps easier in future versions.

0 commit comments

Comments
 (0)