> For the complete documentation index, see [llms.txt](https://docs.vex-nx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vex-nx.com/vex-nx-user-guide-1/images/supported-images.md).

# Supported images

VEX-NX does **not** ship vendor disks. **Supported** means a Catalog template exists, import folder names resolve, and the default console (Serial or VNC) is set correctly. You still bring a legally obtained image.

Live status in the product: **Images -> Catalog** and **Images -> Compatibility**. Community shows the starter pack; Pro unlocks the full catalog after licence import.

Catalog size: **182** templates.

| Status           | Meaning                                                                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **Verified**     | Smoke boot passed here against a user-supplied disk. In Catalog / Compatibility UI this maps to **Tested** (or related Certified vocabulary). |
| **Verified**\*   | Covered via a related Verified template (for example `linux-generic` or `windows-guest`).                                                     |
| **Experimental** | In Catalog / importable; not boot-certified on this platform yet.                                                                             |

This page uses smoke-boot labels. For the live Compatibility chip vocabulary (Certified / Tested / Community verified / ...), see [Catalog and Compatibility](/vex-nx-user-guide-1/images/catalog-and-compatibility.md).

**Import folders** in the table below are folder-name aliases for Convert & add / Bulk import - not canvas **interface aliases** (`e0/0`, `gi0/0`).

QEMU always starts **both** serial and VNC. **Primary** is the default Terminal tab; use **Terminal... -> Open serial** or **Open VNC** for the other backend when both exist.

Heavy appliances (ISE, Nexus Dashboard, XRv9k, ESXi, vCenter) need a larger host than the default OVA - raise vCPU/RAM and enable nested VT-x/EPT first.

## Product list

| Product                       | Template id(s)                         | Runtime  | Primary | Status       | Import folders                            | Notes                                                                     |
| ----------------------------- | -------------------------------------- | -------- | ------- | ------------ | ----------------------------------------- | ------------------------------------------------------------------------- |
| Cisco Dynamips c7200          | `cisco-dynamips-c7200`                 | dynamips | Serial  | Verified\*   | `c7200-*`                                 | PA-FE-TX / PA-4E / PA-8E class images                                     |
| Cisco Dynamips c3725          | `cisco-dynamips-c3725`                 | dynamips | Serial  | Experimental | `c3725-*`                                 | NM-1FE-TX / NM-16ESW                                                      |
| Cisco Dynamips c1710          | `cisco-dynamips-c1710`                 | dynamips | Serial  | Experimental | `c1710-*`                                 |                                                                           |
| Cisco IOL L2                  | `cisco-iol-l2`                         | iol      | Serial  | Experimental | `i86bi*l2*, x86_64_crb*l2*`               | IOU L2                                                                    |
| Cisco IOL L3                  | `cisco-iol-l3`                         | iol      | Serial  | Experimental | `i86bi*L3*, x86_64_crb*linux*`            | IOU L3                                                                    |
| A10 vThunder                  | `a10-vthunder`                         | qemu     | Serial  | Experimental | `a10*, vthunder*`                         | CLI primary; VNC backend also up                                          |
| AlienVault OSSIM              | `alienvault-ossim`                     | qemu     | VNC     | Experimental | `alienvault*, ossim*`                     | GUI install / SIEM UI                                                     |
| Android guest                 | `android-guest`                        | qemu     | VNC     | Experimental | `android*`                                | Graphical guest                                                           |
| Arista Untangle NGFW          | `arista-untangle`                      | qemu     | VNC     | Experimental | `untangle*`                               | Stub; supply Untangle disk                                                |
| Arista vEOS Switch            | `arista-veos`                          | qemu     | Serial  | Verified     | `veos-*`                                  | 2 vCPU / 6 GB; virtio + cdrom.iso; Blank VNC; use serial                  |
| Arista vEOS Router            | `arista-veos`                          | qemu     | Serial  | Verified     | `veos-*`                                  | Same template as switch lab image                                         |
| Arista cEOS                   | `ceos`                                 | qemu     | Serial  | Experimental | `ceos*`                                   |                                                                           |
| Arista CloudEOS               | `cloudeos`                             | qemu     | Serial  | Experimental | `cloudeos*`                               |                                                                           |
| Aruba ClearPass               | `aruba-clearpass`                      | qemu     | VNC     | Experimental | `clearpass*`                              | NAC GUI                                                                   |
| Aruba CX Switch               | `aruba-cx`                             | qemu     | Serial  | Verified     | `arubacx-*`                               |                                                                           |
| Aruba Mobility Controller     | `aruba-vmc`                            | qemu     | VNC     | Experimental | `aruba*vmc*, *mobility*`                  | Virtual MC                                                                |
| Aruba NetEdit                 | `aruba-netedit`                        | qemu     | VNC     | Experimental | `netedit*`                                |                                                                           |
| CheckPoint Gateway            | `checkpoint-gw`                        | qemu     | Serial  | Experimental | `checkpoint*, *cpgw*`                     |                                                                           |
| CheckPoint Management         | `checkpoint-mgmt`                      | qemu     | VNC     | Experimental | `checkpoint*mgmt*, *sms*`                 | SmartConsole era -> VNC                                                   |
| Cyberoam Firewall             | `cyberoam`                             | qemu     | Serial  | Experimental | `cyberoam*`                               |                                                                           |
| Cisco ACS                     | `cisco-acs`                            | qemu     | VNC     | Experimental | `acs*`                                    | Management UI                                                             |
| Cisco AMP Private Cloud       | `cisco-amp`                            | qemu     | VNC     | Experimental | `amp*`                                    |                                                                           |
| Cisco ASA classic             | `cisco-asa`                            | qemu     | Serial  | Experimental | `asa-*`                                   | 8.x multi-context class                                                   |
| Cisco ASAv                    | `cisco-asav`                           | qemu     | Serial  | Verified     | `asav-*`                                  |                                                                           |
| Cisco CSR1000v / CSR SD-WAN   | `csr1000v`                             | qemu     | Serial  | Verified     | `csr1000v*`                               | 16.x/17.x and SD-WAN builds share template                                |
| Cisco Catalyst 8000v          | `catalyst-8000v`                       | qemu     | Serial  | Verified     | `c8000v-*`                                | Also cisco-c8000 alias family                                             |
| Cisco Catalyst 9000v          | `cat9kv`                               | qemu     | Serial  | Verified     | `cat9kv-*, cat9000v*`                     |                                                                           |
| Cisco CUCM                    | `cisco-cucm`                           | qemu     | VNC     | Experimental | `cucm*`                                   | Collaboration GUI                                                         |
| Cisco CUP / IM\&P             | `cisco-cup`                            | qemu     | VNC     | Experimental | `cup*`                                    |                                                                           |
| Cisco UCCX                    | `cisco-uccx`                           | qemu     | VNC     | Experimental | `uccx*`                                   |                                                                           |
| Cisco Unity Express           | `cisco-unity-express`                  | qemu     | VNC     | Experimental | `unity*`                                  |                                                                           |
| Cisco Expressway              | `cisco-expressway`                     | qemu     | VNC     | Experimental | `expressway*`                             |                                                                           |
| Cisco Meeting Server          | `cisco-cms`                            | qemu     | VNC     | Experimental | `cms*`                                    |                                                                           |
| Cisco DCNM                    | `cisco-dcnm`                           | qemu     | VNC     | Experimental | `dcnm*`                                   |                                                                           |
| Cisco Nexus Dashboard         | `cisco-nexus-dashboard`                | qemu     | VNC     | Experimental | `nexus*dashboard*, nd-*`                  |                                                                           |
| Cisco Dynamips images         | `cisco-dynamips-c7200 (+ c3725/c1710)` | dynamips | Serial  | Experimental | `c7200/c3725/c1710`                       | See Dynamips rows                                                         |
| Cisco ESA                     | `cisco-esa`                            | qemu     | Serial  | Experimental | `esa*`                                    | Serial + optional VNC                                                     |
| Cisco Firepower 6 FMC         | `fmcv`                                 | qemu     | Serial  | Verified     | `fmc-*`                                   | 6.x folders; VNC also available                                           |
| Cisco Firepower 7 FMC         | `fmcv`                                 | qemu     | Serial  | Verified     | `fmc7-*`                                  | Same template; version in image name                                      |
| Cisco Firepower 6 FTD         | `ftdv`                                 | qemu     | Serial  | Verified     | `ftd-*`                                   |                                                                           |
| Cisco Firepower 7 FTD         | `ftdv`                                 | qemu     | Serial  | Verified     | `ftd7-*`                                  |                                                                           |
| Cisco NGIPSv / Firepower 5.x  | `cisco-ngipsv`                         | qemu     | Serial  | Experimental | `ngips*`                                  | Also cisco-ips                                                            |
| Cisco IPS 7.x                 | `cisco-ips`                            | qemu     | Serial  | Experimental | `ips*`                                    |                                                                           |
| Cisco IOL                     | `cisco-iol-l2 / cisco-iol-l3`          | iol      | Serial  | Experimental | `i86bi*, x86_64_crb*`                     |                                                                           |
| Cisco ISE                     | `ise`                                  | qemu     | Serial  | Verified     | `ise-*`                                   | Heavy RAM; GUI via HTTPS after boot; VNC optional                         |
| Cisco ISRv                    | `cisco-isrv`                           | qemu     | Serial  | Experimental | `isrv*`                                   |                                                                           |
| Cisco Nexus Titanium / NX-OSv | `nxosv`                                | qemu     | Serial  | Experimental | `nxosv-*`                                 | Deprecated Titanium class                                                 |
| Cisco Nexus 9000v             | `nxosv9000`                            | qemu     | Serial  | Verified     | `nxosv9k-*`                               | Runtime clamp min 2/8GB; recommend 4/12GB                                 |
| Cisco Prime Infra             | `cisco-prime`                          | qemu     | VNC     | Experimental | `prime*`                                  |                                                                           |
| Cisco StealthWatch            | `cisco-stealthwatch`                   | qemu     | VNC     | Experimental | `stealthwatch*`                           |                                                                           |
| Cisco vIOS L3                 | `cisco-iosv`                           | qemu     | Serial  | Verified     | `vios-*`                                  | IDE (`hda`); 1 vCPU / 1 GB; serial not VNC                                |
| Cisco vIOS L2                 | `iosvl2`                               | qemu     | Serial  | Verified     | `viosl2-*`                                | IDE (`hda`); 1 vCPU / 1 GB; serial not VNC                                |
| Cisco SD-WAN Viptela set      | `vbond / vedge / vsmart / vmanage`     | qemu     | Serial  | Verified     | `vtbond-*, vtedge-*, vtsmart-*, vtmgmt-*` | Four-node set                                                             |
| Cisco vWAAS                   | `cisco-vwaas`                          | qemu     | Serial  | Experimental | `vwaas*`                                  |                                                                           |
| Cisco vNAM                    | `cisco-vnam`                           | qemu     | VNC     | Experimental | `vnam*`                                   |                                                                           |
| Cisco Wireless C9800-CL       | `c9800cl`                              | qemu     | Serial  | Verified     | `c9800cl-*`                               |                                                                           |
| Cisco vWLC                    | `cisco-vwlc`                           | qemu     | Serial  | Experimental | `vwlc*`                                   |                                                                           |
| Cisco WSA                     | `cisco-wsa`                            | qemu     | Serial  | Experimental | `wsa*`                                    |                                                                           |
| Cisco SMA Zeus                | `cisco-sma`                            | qemu     | VNC     | Experimental | `sma*`                                    |                                                                           |
| Cisco CDA                     | `cisco-cda`                            | qemu     | Serial  | Experimental | `cda*`                                    |                                                                           |
| Cisco XRv                     | `cisco-xrv`                            | qemu     | Serial  | Experimental | `xrv-*`                                   | Classic XRv                                                               |
| Cisco XRv 9000                | `xrv9k`                                | qemu     | Serial  | Verified     | `xrv9k-*`                                 | Min 4/16GB                                                                |
| Citrix NetScaler              | `netscaler`                            | qemu     | Serial  | Experimental | `netscaler*`                              |                                                                           |
| Citrix SD-WAN                 | `citrix-sdwan`                         | qemu     | Serial  | Experimental | `citrix*sdwan*`                           |                                                                           |
| Clavister Netwall             | `clavister-netwall`                    | qemu     | Serial  | Experimental | `clavister*`                              |                                                                           |
| Cumulus VX                    | `cumulus-vx`                           | qemu     | Serial  | Experimental | `cumulus*`                                |                                                                           |
| Dell OS10                     | `dell-os10`                            | qemu     | Serial  | Experimental | `dell*os10*, os10*`                       |                                                                           |
| Dell SonicWall                | `dell-sonicwall`                       | qemu     | Serial  | Experimental | `dell*sonic*`                             |                                                                           |
| Extreme EXOS                  | `extreme-exos`                         | qemu     | Serial  | Experimental | `exos*`                                   |                                                                           |
| Extreme VOSS                  | `extreme-voss`                         | qemu     | Serial  | Experimental | `voss*`                                   |                                                                           |
| F5 BIG-IP                     | `bigip`                                | qemu     | Serial  | Experimental | `bigip*`                                  | CLI + TMUI later                                                          |
| F5 BIG-IQ                     | `f5-bigiq`                             | qemu     | VNC     | Experimental | `bigiq*`                                  |                                                                           |
| Fortinet FortiGate            | `fortigate`                            | qemu     | Serial  | Verified     | `fortinet-FGT-*, fgt*`                    |                                                                           |
| Fortinet FortiManager         | `fortimanager`                         | qemu     | Serial  | Verified     | `fortimanager-*`                          |                                                                           |
| Fortinet FortiAnalyzer        | `fortianalyzer`                        | qemu     | Serial  | Verified     | `fortianalyzer-*`                         |                                                                           |
| Fortinet Mail                 | `fortinet-mail`                        | qemu     | Serial  | Experimental | `fortimail*`                              |                                                                           |
| Forcepoint NGFW               | `forcepoint-ngfw`                      | qemu     | Serial  | Experimental | `forcepoint*`                             |                                                                           |
| Forcepoint Security Manager   | `forcepoint-smc`                       | qemu     | VNC     | Experimental | `forcepoint*smc*`                         |                                                                           |
| Forescout CounterACT          | `forescout-counteract`                 | qemu     | VNC     | Experimental | `forescout*`                              |                                                                           |
| HP VSR1000                    | `hp-vsr1000`                           | qemu     | Serial  | Experimental | `vsr1000*`                                |                                                                           |
| Hillstone Firewall            | `hillstone-fw`                         | qemu     | Serial  | Experimental | `hillstone*`                              |                                                                           |
| Huawei AR1000v                | `huawei-ar1000v`                       | qemu     | Serial  | Experimental | `ar1000v*`                                |                                                                           |
| Huawei USG6000v               | `huawei-usg6000v`                      | qemu     | Serial  | Experimental | `usg6000*`                                |                                                                           |
| Infoblox DDI                  | `infoblox`                             | qemu     | VNC     | Experimental | `infoblox*`                               |                                                                           |
| Juniper Apstra                | `juniper-apstra`                       | qemu     | VNC     | Experimental | `apstra*`                                 |                                                                           |
| Juniper vJunos Switch         | `vjunos-switch`                        | qemu     | Serial  | Experimental | `vjunos*ex*, vjunos*switch*`              | Dedicated KVM launch profile; 8 vCPU / 8 GB; virtio; bare metal preferred |
| Juniper vJunos EVO            | `vjunos-evolved`                       | qemu     | Serial  | Experimental | `vjunos*evo*`                             | Dedicated KVM launch profile; 8 vCPU / 8 GB; virtio; nested VCP           |
| Juniper vJunos Router         | `vjunos-router`                        | qemu     | Serial  | Experimental | `vjunos*router*`                          | Dedicated KVM launch profile; 8 vCPU / 8 GB; virtio; nested VCP           |
| Juniper J-Space               | `juniper-jspace`                       | qemu     | VNC     | Experimental | `jspace*`                                 | 4 vCPU / 16 GB; virtio                                                    |
| Juniper vMX                   | `vmx`                                  | qemu     | Serial  | Verified     | `vmxvcp-*, vmxvfp-*`                      | Canvas Add pair (VCP+VFP)                                                 |
| Juniper vRouter / Olive       | `juniper-olive`                        | qemu     | Serial  | Experimental | `olive*`                                  | Legacy Olive M-series class                                               |
| Juniper vQFX                  | `vqfx`                                 | qemu     | Serial  | Verified     | `vqfxre-*, vqfxpfe-*`                     | Canvas Add pair (RE+PFE)                                                  |
| Juniper VRR                   | `juniper-vrr`                          | qemu     | Serial  | Experimental | `vrr*`                                    |                                                                           |
| Juniper SD-WAN 128T           | `juniper-128t`                         | qemu     | Serial  | Experimental | `128t*`                                   |                                                                           |
| Juniper vSRX / vSRX NG        | `juniper-vsrx`                         | qemu     | Serial  | Verified     | `vsrx*, vsrxng-*`                         |                                                                           |
| Kemp LoadMaster               | `kemp-loadmaster`                      | qemu     | VNC     | Experimental | `kemp*`                                   |                                                                           |
| Kerio Control                 | `kerio-control`                        | qemu     | VNC     | Experimental | `kerio*`                                  |                                                                           |
| Linux TinyCore                | `linux-tinycore`                       | qemu     | Serial  | Verified\*   | `linux-tinycore-*`                        | Also linux-generic                                                        |
| Linux Slax                    | `linux-slax`                           | qemu     | VNC     | Experimental | `linux-slax*`                             |                                                                           |
| Linux Mint                    | `linux-mint`                           | qemu     | VNC     | Experimental | `linux-mint*`                             |                                                                           |
| Linux Kali                    | `linux-kali`                           | qemu     | VNC     | Experimental | `linux-kali*`                             |                                                                           |
| Linux Ubuntu Desktop          | `linux-desktop`                        | qemu     | VNC     | Verified\*   | `linux-ubuntu*`                           | Desktop -> VNC                                                            |
| Linux Ubuntu Server           | `linux-ubuntu-server`                  | qemu     | Serial  | Experimental | `ubuntu*server*`                          |                                                                           |
| Linux CentOS / RHEL           | `linux-centos`                         | qemu     | Serial  | Experimental | `centos*, rhel*`                          |                                                                           |
| Linux Debian                  | `linux-debian`                         | qemu     | Serial  | Experimental | `debian*`                                 |                                                                           |
| Linux NETem                   | `linux-netem`                          | qemu     | Serial  | Experimental | `netem*`                                  | Delay/loss tool                                                           |
| Linux generic                 | `linux-generic`                        | qemu     | Serial  | Verified     | `linux-*`                                 | Catch-all host                                                            |
| Mikrotik CHR                  | `mikrotik-chr`                         | qemu     | Serial  | Verified     | `mikrotik-*`                              |                                                                           |
| MS Windows Workstation        | `windows-10 / windows-guest`           | qemu     | VNC     | Verified\*   | `win-tiny*, windows*`                     | 7/8.1/10 -> windows-guest or windows-10                                   |
| MS Windows Server             | `windows-server / windows-guest`       | qemu     | VNC     | Verified\*   | `winserver-*`                             | 2003-2022 class                                                           |
| Nokia VSR single node         | `nokia-vsr`                            | qemu     | Serial  | Experimental | `nokia*vsr*, vsr*`                        | Alcatel 7750SR class also alcatel-7750sr                                  |
| Nokia VSR multi line-card     | `nokia-vsr-multi`                      | qemu     | Serial  | Experimental | `nokia*vsr*multi*, *vsr*lc*`              | Companion for multi-LC labs                                               |
| Alcatel 7750SR                | `alcatel-7750sr`                       | qemu     | Serial  | Experimental | `7750*`                                   |                                                                           |
| OPNsense                      | `opnsense`                             | qemu     | Serial  | Experimental | `opnsense*`                               |                                                                           |
| Palo Alto VM-Series           | `pan-vm`                               | qemu     | Serial  | Verified     | `paloalto-*`                              | Runtime clamp min 2/6144 MB; long first boot                              |
| Palo Alto Panorama            | `panorama`                             | qemu     | Serial  | Experimental | `panorama*`                               |                                                                           |
| pfSense 2.4 / 2.5.x           | `pfsense`                              | qemu     | Serial  | Experimental | `pfsense*`                                | One template; version in image name                                       |
| Plixer Scrutinizer            | `plixer-scrutinizer`                   | qemu     | VNC     | Experimental | `plixer*, scrutinizer*`                   |                                                                           |
| Pulse Secure                  | `pulse-secure`                         | qemu     | VNC     | Experimental | `pulse*`                                  |                                                                           |
| Radware Alteon                | `radware-alteon`                       | qemu     | Serial  | Experimental | `alteon*`                                 |                                                                           |
| Riverbed VCX                  | `riverbed-vcx`                         | qemu     | Serial  | Experimental | `riverbed*, vcx*`                         |                                                                           |
| Silver Peak SD-WAN            | `silverpeak-sdwan`                     | qemu     | Serial  | Experimental | `silverpeak*`                             |                                                                           |
| SonicWALL NSv                 | `sonicwall-nsv`                        | qemu     | Serial  | Experimental | `sonicwall*`                              |                                                                           |
| Sophos XG                     | `sophos-xg`                            | qemu     | Serial  | Experimental | `sophos*xg*`                              |                                                                           |
| Sophos SG                     | `sophos-sg`                            | qemu     | Serial  | Experimental | `sophos*sg*`                              |                                                                           |
| Stormshield UTM               | `stormshield-fw`                       | qemu     | Serial  | Experimental | `stormshield*`                            |                                                                           |
| S-Terra FW                    | `sterra-fw`                            | qemu     | Serial  | Experimental | `sterra*`                                 |                                                                           |
| TrendMicro vTPS               | `trendmicro-vtps`                      | qemu     | Serial  | Experimental | `vtps*`                                   |                                                                           |
| Versa FlexVNF SD-WAN          | `versa-flexvnf`                        | qemu     | Serial  | Experimental | `versa*`                                  |                                                                           |
| WatchGuard Firebox            | `watchguard-firebox`                   | qemu     | Serial  | Experimental | `watchguard*, firebox*`                   |                                                                           |
| VMware ESXi                   | `esxi`                                 | qemu     | VNC     | Verified     | `esxi-*, *vSphere*`                       | KVM required at Start; clamp 4/8GB; nested virt                           |
| VMware NSX                    | `vmware-nsx`                           | qemu     | VNC     | Experimental | `nsx*`                                    | Heavy; raise host RAM                                                     |
| VMware vCenter                | `vmware-vcenter`                       | qemu     | VNC     | Experimental | `vcenter*`                                | Heavy OVA                                                                 |
| VMware Velocloud SD-WAN       | `velocloud`                            | qemu     | Serial  | Experimental | `velocloud*`                              |                                                                           |
| VyOS                          | `vyos`                                 | qemu     | Serial  | Experimental | `vyos*`                                   |                                                                           |
| Zabbix                        | `zabbix`                               | qemu     | VNC     | Experimental | `zabbix*`                                 | UI guest                                                                  |
| ZScaler VZEN                  | `zscaler`                              | qemu     | Serial  | Experimental | `zscaler*, vzen*`                         |                                                                           |
| Ostinato                      | `ostinato`                             | qemu     | VNC     | Experimental | `ostinato*`                               | Traffic generator GUI                                                     |
| Apple OSX-KVM                 | `osx-kvm`                              | qemu     | VNC     | Experimental | `osx*, macos*`                            | See OSX-KVM project                                                       |
| Barracuda NGFW                | `barracuda-ngfw`                       | qemu     | Serial  | Experimental | `barracuda*`                              |                                                                           |
| Brocade vADX                  | `brocade-vadx`                         | qemu     | Serial  | Experimental | `vadx*`                                   |                                                                           |

## Status legend

| Mark         | Meaning                                                                    |
| ------------ | -------------------------------------------------------------------------- |
| Verified     | Smoke boot passed on this platform (see appliance-support-matrix)          |
| Verified\*   | Covered via related Verified template (e.g. linux-generic / windows-guest) |
| Experimental | Catalog/import ready; not boot-certified                                   |

## Gaps intentionally not claimed

* Certified suite for every licensed disk without your images
* Shipping vendor images
* Nested ESXi/NSX/vCenter on undersized OVA defaults (raise host RAM first)


---

# 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://docs.vex-nx.com/vex-nx-user-guide-1/images/supported-images.md?ask=<question>&goal=<endgoal>
```

`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.