Skip to content

Commit 0a87a9c

Browse files
author
Michał Gryczka
committed
Removed FAQ, added embeded youtube
1 parent 0ac3423 commit 0a87a9c

File tree

1 file changed

+21
-80
lines changed

1 file changed

+21
-80
lines changed

src/content/blog/macos-migration.mdx

Lines changed: 21 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ tags: ["macos", "migration", "app store", "update", "guide"]
88
draft: false
99
---
1010

11+
import YouTubeVideo from "../../components/video/YouTubeVideo.astro";
12+
1113
![Defguard 1.6 macOS App Store migration guide](/images/blog/macos-migration/macos-migration-1.6.png)
1214

1315
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).
@@ -59,7 +61,15 @@ The migration tool:
5961
4. Click **Migrate**. If everything went well it should display a confirmation message: *“Configuration has been migrated”*.
6062
5. After the migration process, launch Defguard 1.6 from the Mac App Store. Your existing configuration should be available.
6163

62-
> *You can see this method in action on our [video guide](https://youtu.be/dLgC-WsmEsw).*
64+
<YouTubeVideo
65+
videoId="dLgC-WsmEsw"
66+
title="Migrating from Defguard client 1.5 to 1.6"
67+
startAt={0}
68+
showControls={true}
69+
showInfo={true}
70+
allowFullscreen={true}
71+
rel={false}
72+
/>
6373

6474
### Method B - Manual migration (copy/move the settings folder)
6575

@@ -120,7 +130,16 @@ This approach configures Defguard 1.6 as a new client and does not reuse local c
120130

121131
> **Official documentation:** [Desktop client instance configuration guide](https://docs.defguard.net/using-defguard-for-end-users/desktop-client/instance-configuration)
122132
>
123-
> You can also see this method in action on a [video guide](https://youtu.be/dLgC-WsmEsw).
133+
134+
<YouTubeVideo
135+
videoId="FU_Qs6KjMTE"
136+
title="Migrating from Defguard client 1.5 to 1.6"
137+
startAt={0}
138+
showControls={true}
139+
showInfo={true}
140+
allowFullscreen={true}
141+
rel={false}
142+
/>
124143

125144
## Making sure the migration worked
126145

@@ -150,81 +169,3 @@ While technically possible, it's not recommended. Having both versions installed
150169
### What if the migration tool doesn't detect my configuration?
151170

152171
If the migration tool (Method A) doesn't detect your Defguard 1.5 configuration, you can use Method B (manual migration) to copy the settings folder manually, or use Method C (re-enrollment) to set up Defguard 1.6 as a new client.
153-
154-
<script type="application/ld+json" is:inline>
155-
{`{
156-
"@context": "https://schema.org",
157-
"@graph": [
158-
{
159-
"@type": "BlogPosting",
160-
"headline": "New Defguard on macOS: App Store Launch and Migration Guide",
161-
"description": "Defguard 1.6 brings the macOS client to the App Store. Learn why migration is required and how to move your configuration from version 1.5.",
162-
"image": "https://defguard.net/images/blog/macos-migration/macos-migration-1.6.png",
163-
"author": {
164-
"@type": "Organization",
165-
"name": "Defguard Team"
166-
},
167-
"publisher": {
168-
"@type": "Organization",
169-
"name": "Defguard",
170-
"logo": {
171-
"@type": "ImageObject",
172-
"url": "https://defguard.net/svg/logo-full.svg"
173-
}
174-
},
175-
"datePublished": "2025-01-15",
176-
"mainEntityOfPage": {
177-
"@type": "WebPage",
178-
"@id": "https://defguard.net/blog/macos-migration/"
179-
},
180-
"articleSection": "macOS, Migration, App Store, Update, Guide",
181-
"keywords": ["macos", "migration", "app store", "update", "guide", "Defguard", "WireGuard", "VPN"]
182-
},
183-
{
184-
"@type": "FAQPage",
185-
"mainEntity": [
186-
{
187-
"@type": "Question",
188-
"name": "Why can't I just update Defguard 1.5 to 1.6 automatically?",
189-
"acceptedAnswer": {
190-
"@type": "Answer",
191-
"text": "Defguard 1.6 is distributed through the Mac App Store, which uses a different installation method than the PKG installer used for version 1.5. App Store apps are sandboxed, meaning they store data in a different location than non-App Store applications. Because of this, Defguard 1.6 cannot automatically find and use your existing 1.5 configuration."
192-
}
193-
},
194-
{
195-
"@type": "Question",
196-
"name": "Do I need to uninstall Defguard 1.5 before installing 1.6?",
197-
"acceptedAnswer": {
198-
"@type": "Answer",
199-
"text": "No, you don't need to uninstall version 1.5. However, make sure Defguard 1.6 is not running when you perform the migration using Method B (manual migration). After successful migration, you can remove the old PKG version if you no longer need it."
200-
}
201-
},
202-
{
203-
"@type": "Question",
204-
"name": "Will I lose my VPN configuration during migration?",
205-
"acceptedAnswer": {
206-
"@type": "Answer",
207-
"text": "No, if you follow one of the migration methods (A, B, or C), your configuration will be preserved. Method A and B migrate your existing settings, while Method C requires re-enrollment but your VPN instances remain available on the server side."
208-
}
209-
},
210-
{
211-
"@type": "Question",
212-
"name": "Can I use both Defguard 1.5 and 1.6 at the same time?",
213-
"acceptedAnswer": {
214-
"@type": "Answer",
215-
"text": "While technically possible, it's not recommended. Having both versions installed can cause confusion and potential conflicts. We recommend completing the migration to version 1.6 and removing the old PKG version."
216-
}
217-
},
218-
{
219-
"@type": "Question",
220-
"name": "What if the migration tool doesn't detect my configuration?",
221-
"acceptedAnswer": {
222-
"@type": "Answer",
223-
"text": "If the migration tool (Method A) doesn't detect your Defguard 1.5 configuration, you can use Method B (manual migration) to copy the settings folder manually, or use Method C (re-enrollment) to set up Defguard 1.6 as a new client."
224-
}
225-
}
226-
]
227-
}
228-
]
229-
}`}
230-
</script>

0 commit comments

Comments
 (0)