Installing a Maronix Client

Maronix supplies servers. The program you use to reach them is a client, and the choice of client is yours to make.

That distinction matters more than it sounds. Neither of the two clients recommended below is a Maronix product, neither ships servers of its own, and neither sells a VPN subscription. Both are open interfaces for a connection profile that you already hold. You can change one for the other on the same day, on the same subscription, and lose nothing except the settings you had made.

This guide covers two clients across five operating systems: where to download each one, how to install it, and how to add the Maronix subscription so the locations appear in your server list. It stops there. Choosing a location, connecting and finding out whether the tunnel is actually working are separate steps, and How to Check That Your VPN Is Working covers the last of them.

What you’ll need#

• A Maronix account. Request one through the channel. Account and billing both run through Telegram, so this is the first thing to have working.
• Your subscription. The panel gives you two forms of the same thing: a subscription URL to paste, and a QR code to scan. Either one is enough on its own.
• A supported device. Android, iOS, Windows, macOS or Linux. Both clients also reach TV platforms if you need one.
• Ten minutes. Longer the first time, faster every time after.

Choosing between Happ and INCY#

Both clients are built on the Xray core, and both support VLESS with REALITY, which is the pairing Maronix runs. On the protocol side they are interchangeable for this purpose. The difference is maturity, and it is not evenly spread across platforms.

On maturity, take the developers at their word. The INCY project publishes this warning on its own download page, and it is quoted here rather than paraphrased:

The desktop client is pre-alpha. It is usable day to day, but expect rough edges and breaking changes between releases. Please report anything you hit at feedback.incy.cc — that is exactly what this stage is for.

Happ publishes no equivalent warning, ships arm64 builds alongside x64 for every desktop platform, and maintains documentation split into a user section for the general public and a technical section for developers. For a first install on a laptop or desktop, that combination is the safer route. On mobile the two are much closer, and either one is a reasonable pick.

Installing Happ#

Download from happ.su, which lists every build in one place. The documentation lives at docs.happ.info.

On Android#

1. Open the Google Play Store and search for Happ, or install the APK directly from the official site if your device has no Play Store.
2. A separate beta APK is published for anyone who wants unreleased builds.
3. Android TV uses the same Google Play package.

On iOS#

1. Install from the App Store using the Global listing.
2. TestFlight builds are published for both the Global and Rus editions if you want to run a preview.

On Windows#

1. Download the setup installer for your architecture: x64 for most machines, arm64 for ARM-based ones.
2. Run the installer and start Happ when it finishes.

On macOS#

1. Install from the App Store, or download the universal dmg and drag Happ into Applications.

On Linux#

1. Take the package for your distribution: deb for Debian and Ubuntu, rpm for Fedora and Red Hat families, and an Arch pkg.
2. Both x64 and arm64 variants of each are published.

Adding your Maronix subscription to Happ#

Happ documents three ways to add a configuration. The subscription route is the one to use for Maronix, because it keeps updating without you re-entering anything.

Method 1: subscription link (recommended)#

1. Copy the subscription URL from the Maronix panel.
2. Open Happ and press the + button in the upper right corner of the main screen.
3. Choose the subscription option and paste the link, or scan the QR code instead of pasting.
4. Save. The locations appear under the server list on the main screen.

Method 2: QR code#

1. Take the QR code from the panel on a second device, or display it on the device you are setting up.
2. Press +, choose the QR option and allow camera access when prompted.
3. Save once the servers have been read.

Method 3: single link or manual entry#

1. If you were given a single vless:// link rather than a subscription, copy it and add it through the URL option. Happ reads vless://, vmess://, trojan://, ss://, socks://, hysteria2:// and hy2://.
2. If you were given raw parameters, press +, choose manual input, pick VLESS from the protocol list, fill in the fields and press Done.
3. Manual entry is the fallback, not the default. Anything entered this way has to be updated by hand when a server changes.

One detail worth knowing: Happ distinguishes between a standard subscription, which is an ordinary web URL, and an encrypted one whose link begins with happ://crypto. Both work, and in the encrypted form the server settings and the subscription URL are hidden.

Installing INCY#

INCY is distributed through the app stores and through GitHub, where the desktop installers live. The official site is incy.cc.

On Android#

1. Install from the Google Play Store, or sideload the signed APK from GitHub.
2. Android TV uses the same Play Store package.
3. Releases are versioned independently per platform, so an app update notice on one device does not imply an update elsewhere.

On iOS#

1. Install from the App Store. The same listing covers iOS, macOS and Apple TV.

On Windows#

1. Download the setup installer, or the portable zip if you would rather not install anything.
2. Both x64 and arm64 builds are published. Remember this is the pre-alpha desktop client.

On macOS#

1. Download the dmg for your processor: Apple Silicon or Intel.
2. Drag INCY into Applications and open it.

On Linux#

1. Take deb, rpm or Arch pkg for x64 or ARM64, whichever matches your distribution.
2. A portable zip is published as well for systems where you cannot install packages.

Adding your Maronix subscription to INCY#

INCY imports a subscription from a URL, a QR code or a share link, and refreshes it automatically so server changes arrive on their own.

From the subscription URL#

1. Copy the subscription URL from the Maronix panel.
2. Open INCY and add a new subscription.
3. Paste the link. The servers populate the list, and the subscription card shows the name given to it.
4. Leave automatic refresh enabled.

From the QR code#

1. Display the QR code from the panel.
2. Add a new subscription and scan instead of pasting.
3. Save once the servers have been read.

From a single server link#

1. If you hold a vless:// link instead of a subscription, import it the same way. INCY also reads vmess://, trojan://, ss://, socks://, wireguard:// and hysteria2://.
2. A single link gives you one server with no automatic updates, so it suits a one-off test rather than daily use.

INCY’s subscription body may be base64-encoded links, plain links one per line, or a full Xray configuration in JSON. A provider chooses the format; the client accepts all of them. That is a detail you only need if something fails to import, and it is the first thing to ask about if the panel’s link is rejected.

Which client for which device#

There is no single answer, because the two clients are not equally finished everywhere.

• On a laptop or desktop, start with Happ. No published pre-alpha warning, arm64 builds for every platform, and documentation written for end users rather than for integrators.
• On Android or iOS, either one. Both are mature on mobile, both read the same subscription, and switching costs nothing.
• If you want INCY on desktop anyway, take the portable build first so you can judge it without touching your system setup, and keep the GitHub releases page open.
• If you rely on a TV, both ship Apple TV and Android TV builds.

Install both if you are unsure. One subscription, two clients, and the only thing you lose is the settings you configured in the one you leave behind.

Troubleshooting#

Security considerations#

Both clients disclaim the servers in the same words: the servers are yours. Happ states that it includes no servers and provides no VPN service, and that it does not collect VPN data. What it does collect is crash reports and diagnostics through Sentry, plus a device identifier and the device model in the HTTP headers used to fetch subscription data, which the settings let you switch off. INCY publishes the same disclaimer, and adds that mobile builds include Firebase Crashlytics for crash reports while the desktop client sends no telemetry.

Four habits worth forming:

• Download from the developers, not from a search result. happ.su, which now also runs at happ.info, and incy.cc are the official sites; the GitHub organisations and app store listings are linked from them.
• Check the address before you type anything. A lookalike domain is the cheapest attack there is, and this is exactly the traffic that draws them.
• Treat the subscription URL as a credential. Anyone holding it can add your servers to their own client. Do not post it, and regenerate it if it leaks.
• Remember what the client cannot do. A client that is installed correctly still tells your network that you are using a tunnel, and it does not unlink the accounts you sign into afterwards. Privacy versus anonymity draws that line in full.

Once the servers are in your list, the useful next question is whether the tunnel does what you expect it to do. How to Check That Your VPN Is Working walks through the four checks that matter.

Related#

• What Is Maronix? — what the service is before you install anything for it
• Why Maronix Uses VLESS + REALITY — the protocol pair both of these clients speak
• How to Check That Your VPN Is Working — the four checks to run once you are connected
• What Is VLESS? — the protocol you select during manual entry

Sources

1. Happ Proxy Utility Flyfrog LLC
2. Adding Configuration/Subscription Happ
3. Happ documentation Flyfrog LLC
4. INCY INCY LLC
5. INCY documentation (English) INCY
6. INCY platform downloads INCY-DEV

Keep reading

Related in Atlas

Guides 6 min read

What Is Maronix?

Maronix is a privacy project in launch mode: VLESS inside REALITY, independently run servers, Telegram-first access and a trial sized for real use.

Guides 7 min read

Why Maronix Uses VLESS + REALITY

VLESS brings no encryption of its own and REALITY borrows a real site's handshake. Why Maronix pairs them, what each contributes, and what stays exposed.

Guides 4 min read

How to Check That Your VPN Is Working

Four things can keep leaking while a VPN looks connected: your real IP, your DNS resolver, IPv6, and WebRTC. How to test each one, and where browser-only leak tests mislead.

Protocols 4 min read

What Is VLESS?

VLESS is a stateless proxy protocol that does almost nothing on purpose. It hands all encryption to the transport carrying it, which is why it looks like nothing at all.

Last reviewed October 19, 2026. Corrections and additions are welcome.