You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/blog/macos-migration.mdx
+13-11Lines changed: 13 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ import YouTubeVideo from "../../components/video/YouTubeVideo.astro";
12
12
13
13

14
14
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).
16
16
17
17
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.
18
18
@@ -55,12 +55,14 @@ The migration tool:
55
55
56
56
**Step-by-step instructions:**
57
57
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).
59
59
2. Download the **Defguard Migrator app** from the [release assets](https://github.com/DefGuard/client/releases/download/v1.6.1/Defguard.Migrator.zip).
60
60
3. Run the migrator. It should detect the existing 1.5 configuration and a freshly installed 1.6.
61
61
4. Click **Migrate**. If everything went well it should display a confirmation message: *“Configuration has been migrated”*.
62
62
5. After the migration process, launch Defguard 1.6 from the Mac App Store. Your existing configuration should be available.
63
63
64
+
🎥 You can see this method in action on a video guide below:
65
+
64
66
<YouTubeVideo
65
67
videoId="dLgC-WsmEsw"
66
68
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
77
79
78
80
#### Option 1: Step-by-step instructions using Finder
79
81
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).
81
83
2. Make sure Defguard 1.6 is **not running**.
82
84
3. Open **Finder**.
83
85
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
90
92
91
93
#### Option 2: Step-by-step instructions using Terminal
92
94
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).
94
96
2. Make sure Defguard 1.6 is **not running**.
95
97
3. Open **Terminal.app**.
96
98
4. Execute the following commands:
@@ -118,18 +120,15 @@ This method is recommended when you want users to start with a clean Defguard 1.
118
120
3. Click **Add device**.
119
121
4. Select **Remote device activation**.
120
122
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**.
124
126
9. Paste the URL and the Authentication Token.
125
127
10. Name your device.
126
128
11. Confirm the configuration. The instance will appear in the client.
127
129
12. Select the instance and connect to the desired VPN location.
128
130
129
-
This approach configures Defguard 1.6 as a new client and does not reuse local configuration data from version 1.5.
0 commit comments