...

macOS Installation Guide

Install AI Booster on macOS from the App Store or the signed DMG, approve the network extension, and import a profile.


AI Booster on macOS

AI Booster for macOS requires macOS 13.0 (Ventura) or later and runs natively on both Apple Silicon and Intel Macs.

There are two builds, and the difference matters before you choose:

App StoreDMG
SourceApp Store listingDownload page
UpdatesAutomatic, through the App StoreManual — download a newer DMG
Tunnel runs asA sandboxed app extensionA system extension you approve once
Extra approvalNone beyond the VPN configuration promptOne-time approval in System Settings

Both connect the same way and read the same profile formats. The App Store build is the simpler path. Choose the DMG if you want the build signed for direct distribution — for example on a Mac where App Store installs are restricted.

Install from the App Store

  1. Open the listing and check that the developer is the one you expect before installing.
  2. Install and launch AI Booster.
  3. On the first connection macOS shows a "AI Booster would like to add VPN configurations" prompt. This is the system asking permission to install a VPN profile; the connection cannot be established until you allow it.

Install from the DMG

  1. Download the current macOS DMG from the download page.
  2. Check the URL is on dl.allianceinterstellar.com. The DMG is signed with a Developer ID certificate and notarized by Apple, so Gatekeeper should open it without warnings.
  3. Open the disk image and drag AI Booster to Applications.
  4. Launch it from Applications.

If macOS says the app is damaged or cannot be opened, do not disable Gatekeeper or run xattr -d com.apple.quarantine. That message means the signature did not verify, which is exactly the situation the check exists for. Re-download from the link above and, if it repeats, report it rather than bypassing it.

Approve the system extension

The DMG build routes traffic through a network system extension. macOS will not load it until you approve it by hand, and this is the step most people get stuck on, because the connection simply fails with no obvious cause.

Where the switch lives depends on your macOS version, because Apple moved it:

  • macOS 15 Sequoia and later: System Settings → General → Login Items & Extensions → Network Extensions
  • macOS 13 Ventura and 14 Sonoma: System Settings → Privacy & Security, then scroll to the bottom, where macOS shows a prompt to allow the extension shortly after AI Booster requests it.

Enable AI Booster, then connect again. You only do this once per machine — but you may be asked again after a major macOS upgrade.

If you dismissed the prompt and cannot find the switch, quit AI Booster and reopen it. The request is re-sent on launch, which brings the approval back.

Add a profile

AI Booster reads individual node links and subscription URLs. The link schemes it recognises:

SchemeProtocol
vless://VLESS
vmess://VMess
trojan://Trojan
ss://Shadowsocks
hysteria2://, hy2://, hy://Hysteria 2
tuic://TUIC
wg://WireGuard
ssh://SSH
warp://Cloudflare WARP

It also accepts a WireGuard configuration file pasted as text — recognised by its [Interface] header — and an http:// or https:// subscription URL, which is fetched and refreshed rather than stored as a single node.

To import, paste the link into the app, or open a :// link and let macOS hand it to AI Booster.

A subscription URL is a credential: anyone holding it can use your service. Treat it like a password, and prefer regenerating it over sharing it.

Where your configuration lives

Profiles and the generated core configuration are stored in the app group container group.com.ai.booster under your user Library, not in a system-wide location. Nothing is written outside your user account.

Troubleshooting

Connected, but nothing loads. Most often the profile is valid and the node is not. Try another node in the same profile before assuming the app is at fault. The dedicated guide on VPN connected but no internet walks the whole diagnostic order.

Proxy mode left your Mac offline. Proxy mode changes the system-wide proxy settings in Network preferences. If the app is force-quit rather than disconnected, those settings can be left pointing at a port that is no longer listening, and every app on the Mac loses network. Turning the proxy off in System Settings → Network → your interface → Details → Proxies restores it. Always disconnect from inside the app rather than killing the process.

The connection fails immediately on the DMG build. Re-check the system extension approval above. An unapproved extension cannot start the tunnel, and the failure looks identical to a bad profile.

Uninstall

  • App Store build: delete AI Booster from Applications.
  • DMG build: delete the app, then remove the VPN configuration it installed from System Settings → VPN, and disable the extension under Login Items & Extensions.

In both cases, check System Settings → Network → Proxies and confirm nothing is still enabled there before you consider the removal complete.

Feature availability and pricing are shown in the app and on the final purchase sheet. See pricing for the current plans.