Skip to main content

HWID device limit

info

This feature works only with a few client applications (which currently support sending a HWID header when receiving the subscription content).

tip

HWID Device Limit is fully optional and disabled by default.

Overview​

HWID Device Limit is a feature that allows you to restrict the number of devices that can use a subscription.

If the HWID Device Limit is enabled, Remnawave will use HWID and other headers to limit the number of devices that can use a subscription.

Remnawave will strictly enforce the limit on the number of devices that can add the subscription.

danger

If HWID Device Limit is enabled and you do not disable the HWID limit for a user in the panel, it will be impossible for them to get a subscription if their client application does not send a HWID header.

Remnawave will return a 404 error if no HWID header is sent.

Configuration​

You can configure HWID Device Limit in Subscription β†’ Settings β†’ HWID Device Limit. Also, there is possible to override settings for each External Squad.

User limits​

You have the option to set a custom limit for each user. If no value is specified, the fallback limit (HWID_FALLBACK_DEVICE_LIMIT) will be used.

There is also an option to disable HWID Device Limit for each user.

HWID User Limits

In the user card, you can see the list of devices that user has added the subscription onto. You have the option to delete devices from the list. Searching for devices by HWID is also available.

HWID Device Limit Settings

Supported applications​

info

Not all client applications send a HWID header. Here is the list of applications which currently support this feature.

For app developers​

info

A standard for providing headers is offered by Happ.

Remnawave is using these headers to identify the HWID and the device.

To enable support for the HWID feature in your client, the application should send the following headers when the user is adding the subscription.

x-hwid: vfjdhk66csdjhk
x-device-os: iOS
x-ver-os: 18.3
x-device-model: Iphone 14 Pro Max
user-agent: <user_agent>

The only required item is x-hwid. Other headers are optional and can be used to identify the device more accurately.

If your application has the ability to enable additional features based on where the subscription is coming from, Remnawave can send a provider id in the response headers, which you can use to figure out where the subscription is coming from.