Skip to main content
The instapod files commands let you manage files inside your pods without SSH.

​
List Files

instapod files ls my-app
instapod files ls my-app --path /home/instapod/app/src
Lists files and directories. Defaults to the pod’s app root.

​
Read a File

instapod files cat my-app --path /home/instapod/app/index.js
Outputs the file contents to stdout.

​
Write a File

instapod files write my-app --path /home/instapod/app/config.json --content '{"key": "value"}'
Creates or overwrites a file with the given content.

​
Upload a File

instapod files upload my-app --local ./index.html
instapod files upload my-app --local ./dist/bundle.js --remote /home/instapod/app/public/bundle.js
Uploads a local file to the pod. If --remote is not specified, the file is placed in the pod’s app root with the same filename.

​
Sync a Directory

instapod files sync my-app --local ./my-project
Recursively uploads an entire local directory to the pod.

​
Sync Flags

FlagDescriptionDefault
--localLocal directory pathRequired
--remoteRemote directory pathPod’s app root
--excludeGlob patterns to excludeNone
--dry-runPreview what would be uploadedfalse

​
Examples

# Sync with exclusions
instapod files sync my-app --local ./project \
  --exclude "node_modules" \
  --exclude ".git" \
  --exclude "*.log"

# Preview before syncing
instapod files sync my-app --local ./project --dry-run

# Sync to a specific remote path
instapod files sync my-app --local ./build --remote /home/instapod/app/public
The --exclude flag supports glob patterns. Common patterns: node_modules, .git, __pycache__, *.pyc, vendor.