GDAL-VSI(1)

📦
version 3.13.3 · 7 versions
, in alpine 3.24, arch rolling, ubuntu stonking

✨ NAME ✨

gdal-vsi — the entry point for GDAL Virtual System Interface (VSI) commands, bestie 💖

This is the gdal vsi page from the GDAL manual (yes, that's GDAL-VSI(1) if we're being formal, which we are not).

Added in version 3.11. 🎀

Okay so here's the vibe: the subcommands of gdal vsi let you manipulate files that live on the GDAL Virtual File Systems — the compressed ones, the network-hosted ones, all of them. Think /vsimem, /vsizip, /vsitar, /vsicurl, and the rest of the squad. 🦋

🌸 SYNOPSIS 🌸

Usage: gdal vsi <SUBCOMMAND> [OPTIONS]
where <SUBCOMMAND> is one of:
  - copy:   Copy files located on GDAL Virtual System Interface (VSI). (alias: cp)
  - delete: Delete files located on GDAL Virtual System Interface (VSI). (alias: rm, rmdir, del)
  - list:   List files of one of the GDAL Virtual System Interface (VSI). (alias: ls)
  - move:   Move/rename a file/directory located on GDAL Virtual System Interface (VSI). (alias: mv, ren, rename)
  - sozip:  Seek-optimized ZIP (SOZIP) commands.
  - sync:   Synchronize source and target file/directory located on GDAL Virtual System Interface (VSI).

Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

🫶 Common Options, decoded

  • -h, --help — prints the help message and then dips. bye 👋
  • --json-usage — gives you the usage as a JSON document instead, and exits. for the girlies who script 💅
  • --config <KEY>=<VALUE> — sets a configuration option. and yes, you can repeat it as many times as you need. [may be repeated] 🔥

👑 AVAILABLE SUB-COMMANDS 👑

No cap, here's everyone in the group chat:

  • gdal vsi copy
  • gdal vsi delete
  • gdal vsi list
  • gdal vsi move
  • gdal vsi sync
  • gdal vsi sozip

🌈 EXAMPLES 🌈

Example 1: Listing recursively files in /vsis3/bucket with details

$ gdal vsi list -lR /vsis3/bucket

-lR for the details and the recursion?? she ate and left no crumbs 💅

💜 AUTHOR 💜

Even Rouault <even.rouault@spatialys.com> 🌟 — icon behaviour, honestly.

1998-2026

okay that's the whole page bestie, go forth and gdal vsi your little heart out 🧚✨

Signed off from the GDAL manual — version/date stamped Aug 18, 2026 🌸 and yes, the page is GDAL-VSI(1), main character energy from start to finish 💖

📦 where this page comes from