iwctl(1)

📦
version 3.12 · 5 versions
, in alpine 3.24, fedora 44, nixos 26.05, ubuntu resolute, ubuntu stonking

💖 iwctl(1) — internet wireless control utility 💖

okay bestie, so this is the iwctl page from the Linux Connectivity manual section — one (1), for the record. it's your lil' remote control for wireless internet on Linux, and honestly? it's giving main character energy. let's get into it 🦋

✨ NAME ✨

iwctl — internet wireless control utility. yep, that's the whole name. short, sweet, iconic. 👑

🌸 SYNOPSIS 🌸

iwctl [options ...] [commands ...]

so you got options, you got commands, and you can absolutely stack 'em. slay.

💜 DESCRIPTION 💜

iwctl is the tool for configuring the iwd daemon via its D-Bus interface. it's got two whole modes, and she serves in both:

  • interactive mode — you go in, you hang out, you type commands at the [iwd]# prompt
  • command line mode — you fire off one command and dip

lowkey the best of both worlds, no cap. ✨

🎀 OPTIONS 🎀

  • --username, -u — hand over a username. that's it, that's the whole vibe.
  • --password, -p — hand over a password.
  • --passphrase, -P — hand over a passphrase. (yes it's a different flag from password, don't come for me, just use the right one 💅)
  • --dont-ask, -v — don't let iwctl ask you for any missing credentials. she'll just proceed without them.
  • --help, -h — show the help message and exit. the classic. the icon. the moment. 🫶

🦋 EXAMPLES 🦋

🌈 Interactive mode

to start interactive mode and list all the available commands, do this:

$ iwctl
[iwd]# help

and to connect to a network, bestie, it's a whole lil' journey — device list first, then scan, then look at what's out there, then commit:

[iwd]# device list
[iwd]# station DEVICE scan
[iwd]# station DEVICE get-networks
[iwd]# station DEVICE connect SSID

see how it flows? DEVICE and SSID are your placeholders — swap in your actual ones, duh. 🧚

🍓 Command line mode

to list every available command in command line mode and then bounce:

$ iwctl --help

and to connect to a network without ever entering interactive mode, the same steps but with the iwctl prefix every single time — and note that in this mode the passphrase rides in on the flag:

$ iwctl device list
$ iwctl station DEVICE scan
$ iwctl station DEVICE get-networks
$ iwctl --passphrase=PASSPHRASE station DEVICE connect SSID

look at that --passphrase=PASSPHRASE sitting up front before the command — that's the move, iykyk. ⭐

💀 SEE ALSO 💀

  • iwd(8) — the daemon herself. go say hi.

🌸 Author 🌸

Marcel Holtmann <marcel@holtmann.org> — we stan. 🙈

2013-2019 Intel Corporation

fr fr, that's the whole page. every flag, every example, every credit — nothing skipped, bestie. 💖

and finally, the cute sign-off: this beauty comes from iwctl, dated 22 September 2019, and lives at iwctl(1) in the Linux Connectivity manual. so vintage, so iconic, so her. periodt. 🦋✨

📦 where this page comes from