> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/wifi-pineapple-pager/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/wifi-pineapple-pager/ssid-pool.md).
# SSID Pool
The Pineapple SSID Pool is a list of Wi-Fi networks to artificially advertise.
The [Pineapple Open AP](/wifi-pineapple-pager/pineapple-open-ap.md) can mimic any number of SSIDs - but many clients won’t connect to a network if they have not seen a beacon for that network name!
The SSID pool fills this gap by advertising a list of additional networks, enticing clients to send a connection request which the Open AP is able to capture.
### Filling in the SSID Pool
The first step to using the SSID pool functionality is to add SSIDs to the list.
SSIDs can be added manually or automatically.
**Manually adding SSIDs**
SSIDs can be added via the UI from the PineAP options, under `PineAP` > `SSID Pool`
PineAP SSID Pool Configuration
PineAP SSID Pool List
PineAP SSID Pool Editing
SSIDs can also be manipulated via the command line (either via `ssh`, the Virtual Pager, or in a payload) using the `PINEAPPLE_SSID_POOL_ADD`, `PINEAPPLE_SSID_POOL_LIST`, and `PINEAPPLE_SSID_POOL_DELETE` DuckyScript commands.
**Automatically adding SSIDs**
The Pineapple recon system can also automatically collect probed SSIDs - network names clients have explicitly searched for. This allows the pool to automatically adapt to the client environment.
Automatic collection can be enabled via the UI under `PineAP` > `Collect Probes`
PineAP probe collection
Or via the command line with the `PINEAPPLE_SSID_POOL_COLLECT_START` and `PINEAPPLE_SSID_POOL_COLLECT_STOP` DuckyScript commands.
{% hint style="info" %}
Remember your filters!\
\
When the Network filter is set to `ALLOW` mode, you will need to add any SSIDs in the SSID Pool to the allowed list!
{% endhint %}
### Enabling SSID Pool advertising
To actually transmit SSIDs in the pool, you must enable advertising. This is done in the UI under `PineAP` > `Advertise Network`.
PineAP SSID pool advertising
Similarly, via the command line or payloads, the `PINEAPPLE_SSID_POOL_START` and `PINEAPPLE_SSID_POOL_STOP` DuckyScript commands control advertising.
**Address randomization**
By default, PineAP uses the MAC address (BSSID) of the Open AP interface. This tends to have the most success with most clients, however some Wireless monitoring systems and intrusion detection systems may easily detect that a single access point is acting unusually.
The `Randomize Address` option allows PineAP to generate random BSSID addresses for each SSID, which makes it less obvious that one device may be emulating many networks - however many modern WiFi clients will not attempt to connect to the Pineapple Open AP if the addresses do not match.
Your mileage may vary - try both options depending on the types of clients you are targetting!
### SSID Pool size
The SSID Pool is limited to 64 SSIDs - Each SSID takes time to advertise, and must be advertised for multiple seconds before a client will attempt to connect to it.
When adding SSIDs, the oldest SSIDs in the pool list are automatically expired as new SSIDs are added.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://documentation.hak5.org/wifi-pineapple-pager/ssid-pool.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.