Your home. Your rules. on NQ2

NQ2 Local 1.0.0

Sat, 24 Oct 2026 00:00:00 +0200

NQ2 is the main application that runs locally on your device. The package is universal: install dependencies from package.json on the target device before starting the application.

Download

NQ2 1.0.0

Download NQ2 · ZIP

File size: 0.64 MB (640,724 bytes)

Verify the download

SHA-256: 1ba21f25b09ba3d7461e60516216cb9ab2e681e7df2fbf733260eeb77448fe5f

Download checksum file

For automated downloads, use the latest NQ2 ZIP. The latest release JSON provides version, released_at (release date in YYYY-MM-DD format), download URLs, and size in bytes. These addresses update after deployment; the download card above always points to version 1.0.0.

Core concepts: from providers to cards

Tue, 27 Oct 2026 00:00:00 +0100

Zones and subzones

Zones organise your installation by location. A flat might have a living room, kitchen and bathroom; a larger property might have a house and garden, with floors and rooms nested below them.

Providers and devices

A provider is one instance of an integration, such as Zigbee2MQTT or Sonos2MQTT. Pair or configure devices in that application’s own interface first. The provider then exposes its devices, and you select which ones to register in NQ2. You can use more than one provider instance.

How to add content to the knowledge base

Tue, 29 Sep 2026 00:00:00 +0200

Every article is a Markdown file in content/en/ (English) or content/pl/ (Polish). Always use English directory and file names. Choose a section, add both versions of your article, and push your changes to master.

Choose a section

Directory	What belongs here
`docs/`	Application instructions and configuration guides
`integrations/`	API documentation, connections, and data exchange
`snippets/`	Short, reusable code examples
`scripts/`	Complete scripts with configuration and usage instructions
`apps/`	Application releases to download and install yourself
`blog/`	Articles, updates, and development notes

Create an article

Create content/en/docs/my-guide/ and content/pl/docs/my-guide/, each containing an index.md file. Matching paths let Hugo associate the translations. Start the English version with:

Installing NQ2

Sun, 25 Oct 2026 00:00:00 +0200

Choose the path that matches your device. The installer package contains platform-specific launchers and a shared config.yaml; the application ZIP contains NQ2 itself. They are different downloads.

Path 1: a fresh Raspberry Pi card

Use the Raspberry Pi guide with 16 screenshots. Write Raspberry Pi OS Lite (64-bit) with Raspberry Pi Imager, configure the account and network there, then run windows/raspianimager.cmd on your Windows computer to add the NQ2 first-boot installer. Only then eject the card and start the Pi.

Raspberry Pi: install with the script

Sun, 25 Oct 2026 00:00:00 +0200

This path prepares a new card on a Windows computer, then installs the applications during the Raspberry Pi’s first boot. You need a Pi that supports a 64-bit OS, a microSD card with room for the OS and applications, a reader, a power supply and internet access on the computer and Pi. Screenshots show Imager’s English interface, with English explanations below.

If the system is already running, follow installation on an existing system. If you prepare the card on macOS or Linux, write the OS with Imager, boot the Pi and run the Linux installer there over SSH; do not run the .cmd on those platforms.

Install on an existing system

Sun, 25 Oct 2026 00:00:00 +0200

Use this method when the target OS is already installed and you can sign in. You do not need to rewrite a card or run the card-preparation wizard. If you prefer individual commands, follow manual Linux installation.

Download and choose the target

NQ2 installer

Download NQ2 · ZIP

File size: 0.11 MB (114,948 bytes)

Verify the download

SHA-256: bab5347cdf66ec2cedb0c5ebbb546ae10b2b4e0223f223d67d50bcb2b09a1873

Download checksum file

Extract the complete nq2-installation folder. Keep core, config.yaml and the platform folders together. config.yaml is shared by all launchers; its comments are in English and the wizard can run in EN or PL.

Manual NQ2 installation on Linux

Sun, 25 Oct 2026 00:00:00 +0200

Perform the steps yourself instead of running the NQ2 installer. These commands match the current installer defaults: NQ2 latest and Zigbee2MQTT 2.14.2.

Order: dependencies → NQ2 → Nginx → Mosquitto → Zigbee2MQTT. NQ2 and common dependencies are required. Nginx, Mosquitto and Zigbee2MQTT are optional and enabled by default. Skip sections marked “optional” to omit a component. Without Nginx, use port 8080. Without Mosquitto, use an existing broker and enter its address and credentials in Zigbee2MQTT configuration. Common tools (Node.js, PM2, Corepack and build tools) are installed first; Zigbee2MQTT npm dependencies and compilation follow its source download at the end.

Stable Wi-Fi on Raspberry Pi

Wed, 28 Oct 2026 00:00:00 +0100

If NQ2 or SSH becomes unreachable over Wi-Fi after the device has been idle, disable Wi-Fi power saving on the Raspberry Pi. On some hardware/driver combinations it can contribute to intermittent connection loss. The Pi may still be running even though it appears offline: losing Wi-Fi is not the same as the whole device shutting down.

For an NQ2 server connected over Wi-Fi, configure this setting during installation. The current NQ2 installer does this automatically on Linux systems using NetworkManager. For a manual installation or a device installed with an older bundle, use the steps below. A computer writing the card does not need this change; apply it on the Raspberry Pi or Linux server that runs NQ2.

Why NQ2 connects applications

Tue, 27 Oct 2026 00:00:00 +0100

One everyday action, several applications

Imagine pressing a Zigbee button to play music on a Sonos speaker. Pairing the button belongs in Zigbee2MQTT. Building the playlist belongs in a music application. Connecting the press to playback is the job of an integrator.

That is the idea behind NQ2: give everyday controls a common home while keeping specialised applications useful in their own right.

Cards bridge the gap

A card is not tied to one physical device. A gate card can combine a camera, a sensor and a relay. The people using it see the action they need rather than the boundaries between integrations.

NQ2 Local 1.0.1

Mon, 26 Oct 2026 00:00:00 +0100

Download

NQ2 1.0.1

Download NQ2 · ZIP

File size: 0.65 MB (647,206 bytes)

Verify the download

SHA-256: 37d6c1448a5697c8f3740cac2f04db3b593b2aab39fec4a7bf2c16840da15ecb

Download checksum file

Version: 1.0.1. This download always points to this specific release. Automated installations can use the latest package and release metadata.

Package contents

Bundled Local API and web interface, without node_modules or private .env files.
Empty database and definitions directories, except any README files.
The Sun and Zigbee2MQTT integrations and the explicitly allowed public scripts.

Installation

Extract the ZIP, enter its directory, run npm install, then npm start. Change the initial administrator credentials before exposing the application. See manual installation.

Formatting dates in Polish

Tue, 29 Sep 2026 00:00:00 +0200

Intl.DateTimeFormat formats dates without additional libraries.

Code

const formatDate = new Intl.DateTimeFormat('pl-PL', {
 dateStyle: 'long',
 timeZone: 'Europe/Warsaw',
});

formatDate.format(new Date('2026-09-29T12:00:00Z'));
// "29 września 2026"

When to use it

An explicit time zone produces consistent results regardless of device settings. Pass the input as an ISO date with a time zone, such as the Z suffix for UTC. This example intentionally produces a Polish date; use en-US as the locale for English output.

How to document an integration

Tue, 29 Sep 2026 00:00:00 +0200

This is an authoring guide. It does not describe an existing NQ2 API. Fill in actual URLs, parameters, and requirements based on the integration you implement.

Purpose and requirements

Explain which data moves between the application and the service, in which direction, and when. Specify the required application version and account permissions.

Configuration

List the configuration fields and explain their meaning. Use placeholders such as YOUR_TOKEN instead of real credentials in examples.

One place for NQ2 knowledge

Tue, 29 Sep 2026 00:00:00 +0200

The NQ2 knowledge base gives instructions, examples, and decisions a permanent home.

What you will find here

Documentation — instructions and explanations of application behavior.
Integrations — materials about connecting the application to services.
Snippets — short code examples to reuse.
Blog — updates and development notes.

The initial articles explain how to add content. Documentation for specific features will grow alongside the application.

Knowledge stored in Markdown

Every article is a plain text file you can edit locally or on GitHub. The repository keeps the change history, and pushing to master triggers site publication.

A home that works together.

Mon, 01 Jan 0001 00:00:00 +0000

One control centre, dedicated applications

NQ2 connects independent applications through MQTT and HTTP. Use cards for everyday actions while dedicated applications handle detailed tasks: pairing Zigbee devices, browsing a Sonos library or reviewing camera recordings.

An integration instance is a provider. It exposes devices that you choose to register in NQ2. Multiple instances of a provider can serve different parts of an installation.

Cards describe what you want to control

A card can combine several devices, show part of one device or work without a physical device. A gate card might bring together a Reolink camera, a Zigbee contact sensor and a relay from another provider. Zones and subzones organise the installation around rooms, floors or buildings.

Applications working together. People in control.

Mon, 01 Jan 0001 00:00:00 +0000

Why NQ2 exists

A connected home brings together devices from different manufacturers and applications with different strengths. NQ2 is designed to connect those parts and give them a shared place for everyday control and automation.

A music application can remain the best place to build playlists. A camera application can remain the place to review recordings. NQ2 connects the actions and events that make these systems useful together.

What guides the product

Local control. The installation in your home handles your devices and automations. Optional online access is a separate choice.