Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(baileys): describe the Ubuntu device name as observed (#1861)

Yudhi Armyndharis8f6485c6232c
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f916e9e0e..cbfde2265 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -149,7 +149,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- With `OPENWA_DATA_DIR` set, `backup.sh` and `restore.sh` read the default SQLite databases and `./data/...` paths in `./.env` under it; pass a path in the environment to keep it in the working directory.
- A storage import stops at `STORAGE_IMPORT_MAX_TOTAL_BYTES` (default 10 GiB); raise it before importing a larger export.
- Baileys answers `400` for an animated sticker with more than 500 frames.
-- New Baileys pairings appear as `Chrome (Ubuntu)` in Linked Devices; set `BAILEYS_BROWSER_NAME=OpenWA` to keep the old name. Linked sessions are unaffected.
+- New Baileys pairings show `Ubuntu` instead of `OpenWA` as the device name in Linked Devices; set `BAILEYS_BROWSER_NAME=OpenWA` to keep the old name. Linked sessions are unaffected.
- `backup.sh` and `restore.sh` exit with status 2 when `./.env` or `.env.generated` sets a key in a form they cannot parse; fix the line or pass the key in the environment.
- With `DATABASE_SSL=true`, `backup.sh` now fails against a PostgreSQL server whose certificate the app would reject; trust a private CA through `NODE_EXTRA_CA_CERTS` or `PGSSLROOTCERT`, and give `DATABASE_URL` the host name the certificate carries or set `PGSSLMODE`.
diff --git a/src/engine/adapters/baileys-lifecycle.ts b/src/engine/adapters/baileys-lifecycle.ts
index 183104f25..23850eb27 100644
--- a/src/engine/adapters/baileys-lifecycle.ts
+++ b/src/engine/adapters/baileys-lifecycle.ts
@@ -30,8 +30,8 @@ import type { BaileysSessionStore } from './baileys-session-store';
import { userPart } from '../identity/wa-id';
/** Linked-device identity shown in WhatsApp (Settings → Linked Devices). The OS platform is
- * operator-configurable via BAILEYS_BROWSER_NAME; defaults to canonical 'Ubuntu' so pairing-code
- * (link-code) companion registration passes WhatsApp server-side validation. */
+ * operator-configurable via BAILEYS_BROWSER_NAME; defaults to 'Ubuntu' because some accounts reject a
+ * non-standard name on phone-number (pairing-code) linking. Only new pairings carry the name. */
const BAILEYS_BROWSER: [string, string, string] = [
process.env.BAILEYS_BROWSER_NAME?.trim() || 'Ubuntu',
'Chrome',