Skip to content

Commit 8b54178

Browse files
authored
Fix blog article (#140)
1 parent adc3f26 commit 8b54178

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

src/content/blog/macos-migration.mdx

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ import YouTubeVideo from "../../components/video/YouTubeVideo.astro";
1212

1313
![Defguard 1.6 macOS App Store migration guide](/images/blog/macos-migration/macos-migration-1.6.png)
1414

15-
Defguard 1.6 introduces an important change for macOS users: the Desktop Client now integrates with the macOS system and removes the dependency on external WireGuard binaries, which makes App Store distribution possible. For a complete overview of all new features in Defguard 1.6, see our [release notes](/blog/defguard-1.6-release-notes).
15+
Defguard 1.6 introduces an important change for macOS users: the Desktop Client now integrates with the macOS system and removes the dependency on external WireGuard binaries, which makes App Store distribution possible. For a complete overview of all new features in Defguard 1.6, see our [release notes](/blog/defguard-16-release-notes).
1616

1717
Because of Apple’s restrictive rules for App Store apps (each app is isolated and access to its data is restricted by non‑App‑Store apps), migrating from **Defguard 1.5 (PKG)** to **1.6 (App Store)** is not a “regular upgrade” and requires moving your 1.5 client settings or re‑enrolling in the new version.
1818

@@ -55,12 +55,14 @@ The migration tool:
5555

5656
**Step-by-step instructions:**
5757

58-
1. Install Defguard Desktop Client from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
58+
1. Install Defguard Desktop Client 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
5959
2. Download the **Defguard Migrator app** from the [release assets](https://github.com/DefGuard/client/releases/download/v1.6.1/Defguard.Migrator.zip).
6060
3. Run the migrator. It should detect the existing 1.5 configuration and a freshly installed 1.6.
6161
4. Click **Migrate**. If everything went well it should display a confirmation message: *“Configuration has been migrated”*.
6262
5. After the migration process, launch Defguard 1.6 from the Mac App Store. Your existing configuration should be available.
6363

64+
🎥 You can see this method in action on a video guide below:
65+
6466
<YouTubeVideo
6567
videoId="dLgC-WsmEsw"
6668
title="Migrating from Defguard client 1.5 to 1.6"
@@ -77,7 +79,7 @@ This method preserves local client settings by manually moving them from the 1.5
7779

7880
#### Option 1: Step-by-step instructions using Finder
7981

80-
1. Install Defguard 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
82+
1. Install Defguard Desktop Client 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
8183
2. Make sure Defguard 1.6 is **not running**.
8284
3. Open **Finder**.
8385
4. From the menu bar, select **Go**.
@@ -90,7 +92,7 @@ This method preserves local client settings by manually moving them from the 1.5
9092

9193
#### Option 2: Step-by-step instructions using Terminal
9294

93-
1. Install Defguard 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
95+
1. Install Defguard Desktop Client 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
9496
2. Make sure Defguard 1.6 is **not running**.
9597
3. Open **Terminal.app**.
9698
4. Execute the following commands:
@@ -118,18 +120,15 @@ This method is recommended when you want users to start with a clean Defguard 1.
118120
3. Click **Add device**.
119121
4. Select **Remote device activation**.
120122
5. Copy the URL and Authentication Token.
121-
6. Install Defguard 1.6 from the Mac App Store.
122-
7. Open the Defguard 1.6 desktop client.
123-
8. Click **add instance**.
123+
6. Install Defguard Desktop Client 1.6 from the [Mac App Store](https://apps.apple.com/pl/app/defguard-desktop-client/id6754601166?mt=12).
124+
7. Open the Defguard Desktop Client 1.6.
125+
8. Click the **Add instance**.
124126
9. Paste the URL and the Authentication Token.
125127
10. Name your device.
126128
11. Confirm the configuration. The instance will appear in the client.
127129
12. Select the instance and connect to the desired VPN location.
128130

129-
This approach configures Defguard 1.6 as a new client and does not reuse local configuration data from version 1.5.
130-
131-
> **Official documentation:** [Desktop client instance configuration guide](https://docs.defguard.net/using-defguard-for-end-users/desktop-client/instance-configuration)
132-
>
131+
🎥 You can see this method in action on a video guide below:
133132

134133
<YouTubeVideo
135134
videoId="FU_Qs6KjMTE"
@@ -141,6 +140,9 @@ This approach configures Defguard 1.6 as a new client and does not reuse local c
141140
rel={false}
142141
/>
143142

143+
> **Official documentation:** [Desktop client instance configuration guide](https://docs.defguard.net/using-defguard-for-end-users/desktop-client/instance-configuration)
144+
>
145+
144146
## Making sure the migration worked
145147

146148
Launch Defguard 1.6 and verify:

0 commit comments

Comments
 (0)