Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

docs: reorganize Coder Desktop docs#18871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
matifali merged 8 commits intomainfromatif/coder-desktop-docs
Sep 5, 2025
Merged
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
183 changes: 101 additions & 82 deletionsdocs/user-guides/desktop/index.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,145 +1,164 @@
#Coder Desktop

Coder Desktop provides seamless access to your remote workspaces without the need to install a CLI or configure manual port forwarding.
Connect to workspace services using simple hostnames like`myworkspace.coder`, launch native applications with one click,
and synchronize files between local and remote environments.
Coder Desktop provides seamless access to your remote workspaces through a native application. Connect to workspace services using simple hostnames like`myworkspace.coder`, launch applications with one click, and synchronize files between local and remote environments—all without installing a CLI or configuring manual port forwarding.

Coder Desktop requires a Coder deployment running[v2.20.0](https://github.com/coder/coder/releases/tag/v2.20.0) or later.
##What You'll Need

##Install Coder Desktop
- A Coder deployment running`v2.20.0` or[later](https://github.com/coder/coder/releases/latest)
- Administrator privileges on your local machine (for VPN extension installation)
- Access to your Coder deployment URL

<divclass="tabs">

You can install Coder Desktop on macOS or Windows.

###macOS

1. Use[Homebrew](https://brew.sh/) to install Coder Desktop:

```shell
brew install --cask coder/coder/coder-desktop
```
##Quick Start

Alternatively, you can manually install Coder Desktop from the[releases page](https://github.com/coder/coder-desktop-macos/releases).
1. Install:`brew install --cask coder/coder/coder-desktop` (macOS) or`winget install Coder.CoderDesktop` (Windows)
1. Open Coder Desktop and approve any system prompts to complete the installation.
1. Sign in with your deployment URL and session token
1. Enable "Coder Connect" toggle
1. Access workspaces at`workspace-name.coder`

1. Open**Coder Desktop** from the Applications directory.
##How It Works

1. The application is treated as a system VPN. macOS will prompt you to confirm with:
**Coder Connect** the primmary component of Coder Desktop creates a secure tunnel to your Coder deployment, allowing you to:

**"Coder Desktop" would like to use a new network extension**
-**Access workspaces directly**: Connect via`workspace-name.coder` hostnames
-**Use any application**: SSH clients, browsers, IDEs work seamlessly
-**Sync files**: Bidirectional sync between local and remote directories
-**Work offline**: Edit files locally, sync when reconnected

Select**Open System Settings**.
The VPN extension routes only Coder traffic—your other internet activity remains unchanged.

1. In the**Network Extensions** system settings, enable the Coder Desktop extension.
##Installation

1. Continue to the[configuration section](#configure).
<divclass="tabs">

###Windows
###macOS

If you use[WinGet](https://github.com/microsoft/winget-cli), run`winget install Coder.CoderDesktop`.
<divclass="tabs">

To manually install Coder Desktop:
####Homebrew (Recommended)

1. Download the latest`CoderDesktop` installer executable (`.exe`) from the[coder-desktop-windows release page](https://github.com/coder/coder-desktop-windows/releases).
```shell
brew install --cask coder/coder/coder-desktop
```

Choose the architecture that fits your Windows system,`x64` or`arm64`.
####Manual Installation

1. Open the`.exe` file, acknowledge the license terms and conditions, and select**Install**.
1. Download the latest release from[coder-desktop-macos releases](https://github.com/coder/coder-desktop-macos/releases)
1. Drag`Coder Desktop.app` to your Applications folder
1. Open from Applications directory
Comment on lines +46 to +48
Copy link
Member

@ethanndicksonethanndicksonSep 9, 2025•
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

We only ship a.pkg now, so there's no drag and drop installation in the latest version, you have to run the installer.


1. If a suitable .NET runtime is not already installed, the installation might prompt you with the**.NET Windows Desktop Runtime** installation.
</div>

In that installation window, select**Install**. Select**Close** when the runtime installation completes.
Coder Desktop requires VPN extension permissions:

1. When the Coder Desktop installation completes, select**Close**.
1. When prompted with**"Coder Desktop" would like to use a new network extension**, select**Open System Settings**
1. In**Network Extensions** settings, enable the Coder Desktop extension
1. You may need to enter your password to authorize the extension

1. Find and open**Coder Desktop** fromyourStart Menu.
✅**Verify Installation**:Coder Desktop should appear inyourmenu bar

1. Some systems require an additionalWindows App Runtime SDK.
###Windows

Select**Yes** if you are prompted to install it.
This will open your default browser where you can download and install the latest stable release of the Windows App Runtime SDK.
<divclass="tabs">

Reopen Coder Desktop after you install the runtime.
####WinGet (Recommended)

1. Coder Desktop starts minimized in the Windows System Tray.
```shell
winget install Coder.CoderDesktop
```

You might need to select the**^** in your system tray to show more icons.
####Manual Installation

1. Continue to the[configuration section](#configure).
1. Download the latest`CoderDesktop` installer (`.exe`) from[coder-desktop-windows releases](https://github.com/coder/coder-desktop-windows/releases)
1. Choose the correct architecture (`x64` or`arm64`) for your system
1. Run the installer and accept the license terms
1. If prompted, install the .NET Windows Desktop Runtime
1. Install Windows App Runtime SDK if prompted

</div>

##Configure

Before you can use Coder Desktop, you will need to sign in.

1. Open the Desktop menu and select**Sign in**:
-[.NET Windows Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) (installed automatically if not present)
- Windows App Runtime SDK (may require manual installation)

<divclass="tabs">
✅**Verify Installation**: Coder Desktop should appear in your system tray (you may need to click**^** to show hidden icons)

##macOS
</div>

![Coder Desktop menu before the user signs in](../../images/user-guides/desktop/coder-desktop-mac-pre-sign-in.png)
##Testing Your Connection

##Windows
Once connected, test access to your workspaces:

![Coder Desktop menu before the user signs in](../../images/user-guides/desktop/coder-desktop-win-pre-sign-in.png)
<divclass="tabs">

</div>
###SSH Connection

1. In the**Sign In** window, enter your Coder deployment's URL and select**Next**:
```shell
ssh your-workspace.coder
```

![Coder Desktop sign in](../../images/user-guides/desktop/coder-desktop-sign-in.png)
###Ping Test

1. macOS: Select the link to your deployment's`/cli-auth` page to generate a[session token](../../admin/users/sessions-tokens.md).
```shell
# macOS
ping6 -c 3 your-workspace.coder

Windows: Select**Generate a token via the Web UI**.
# Windows
ping -n 3 your-workspace.coder
```

1. In your web browser, you may be prompted to sign in to Coder with your credentials.
###Web Services

1. Copythesession tokentothe clipboard:
Open`http://your-workspace.coder:PORT` in your browser, replacing`PORT` withthespecific service port you wanttoaccess (e.g. 3000 for frontend, 8080 for API)

![Copy session token](../../images/templates/coder-session-token.png)
</div>

1. Paste the token in the**Session Token** field of the**Sign In** screen, then select**Sign In**:
##Troubleshooting

![Paste the session token in to sign in](../../images/user-guides/desktop/coder-desktop-session-token.png)
###Connection Issues

1. macOS: Allow the VPN configuration for Coder Desktop if you are prompted:
####Can't connect to workspace

![Copy session token](../../images/user-guides/desktop/mac-allow-vpn.png)
- Verify Coder Connect is enabled (toggle should be ON)
- Check that your deployment URL is correct
- Ensure your session token hasn't expired
- Try disconnecting and reconnecting Coder Connect

1. Select the Coder icon in the menu bar (macOS) or system tray (Windows), and click the**Coder Connect** toggle to enable the connection.
####VPN extension not working

![Coder Desktop on Windows - enable Coder Connect](../../images/user-guides/desktop/coder-desktop-win-enable-coder-connect.png)
- Restart Coder Desktop
- Check system permissions for network extensions
- Ensure only one copy of Coder Desktop is installed

This may take a few moments, because Coder Desktop will download the necessary components from the Coder server if they have been updated.
###Known Limitations

1. macOS: You may be prompted to enter your password to allow Coder Connect to start.
####Secure Browser Context

1.Coder Connectis now running!
Some web applications require HTTPS for certain features. WhileCoder Connectuses encrypted WireGuard tunnels, browsers may show security warnings for HTTP connections to`.coder` hostnames.

##Troubleshooting
###Getting Help

If you encounter an issue with Coder Desktop that is not listed here, file an issue in the GitHub repository for
Coder Desktop for[macOS](https://github.com/coder/coder-desktop-macos/issues) or
[Windows](https://github.com/coder/coder-desktop-windows/issues), in the
[main Coder repository](https://github.com/coder/coder/issues), or consult the
[community on Discord](https://coder.com/chat).
If you encounter issues not covered here:

###Known Issues
-**File an issue**:[macOS](https://github.com/coder/coder-desktop-macos/issues) |[Windows](https://github.com/coder/coder-desktop-windows/issues) |[General](https://github.com/coder/coder/issues)
-**Community support**:[Discord](https://coder.com/chat)

####macOS: Do not install more than one copy of Coder Desktop
##Uninstalling

To avoid system VPN configuration conflicts, only one copy of`Coder Desktop.app` should exist on your Mac, and it must remain in`/Applications`.
<divclass="tabs">

####Coder Desktop can't connect through another VPN
###macOS

If the logged in Coder deployment requires a corporate VPN to connect, Coder Connect can't establish communication
through the VPN, and will time out.
1.**Disable Coder Connect** in the app menu
2.**Quit Coder Desktop** completely
3.**Remove VPN extension** from System Settings > Network Extensions
4.**Delete the app** from Applications folder
5.**Remove configuration** (optional):`rm -rf ~/Library/Application\ Support/Coder\ Desktop`

This issue has been fixed in Coder v2.24.3 and later. For macOS clients, Coder Desktop v0.8.0 or later is also required.
###Windows

##Next Steps
1.**Disable Coder Connect** in the app menu
2.**Quit Coder Desktop** from system tray
3.**Uninstall** via Settings > Apps or Control Panel
4.**Remove configuration** (optional): Delete`%APPDATA%\Coder Desktop`

-[Connect to and work on your workspace](./desktop-connect-sync.md)
</div>
Loading
[8]ページ先頭
©2009-2025 Movatter.jp