Home CLI volume railway volume
Manage persistent storage volumes for your services.
Subcommand Aliases Description listlsList volumes addcreate, newAdd a new volume deleteremove, rmDelete a volume updateedit, renameUpdate a volume detachDetach a volume from a service filesfileManage files in a volume browsebrowserBrowse files in a volume interactively attachAttach a volume to a service
Opens an interactive TUI for browsing, downloading, uploading, editing, renaming, and deleting files in the volume.
Flag Description -s, --service <SERVICE>Service ID -e, --environment <ENV>Environment ID -p, --project <PROJECT_ID>Project ID --jsonOutput in JSON format
Flag Description -m, --mount-path <PATH>Mount path for the volume (must start with /)
Flag Description -v, --volume <VOLUME>Volume ID or name -y, --yesSkip confirmation --2fa-code <CODE>2FA code for verification
Flag Description -v, --volume <VOLUME>Volume ID or name -m, --mount-path <PATH>New mount path -n, --name <NAME>New name for the volume
Flag Description -v, --volume <VOLUME>Volume ID or name to detach -y, --yesSkip confirmation --jsonOutput in JSON format
Flag Description -v, --volume <VOLUME>Volume ID or name to attach -y, --yesSkip confirmation --jsonOutput in JSON format
Use railway volume files to manage files in a volume from scripts or non-interactive workflows.
Subcommand Aliases Description listlsList files in a directory browsebrowserBrowse files interactively downloadDownload a file or directory uploadUpload a file or directory deleterm, removeDelete a file renamemvRename a file
Flag Description -v, --volume <VOLUME>Volume ID or name. Without this flag, the CLI prompts you to choose one
The -v, --volume flag must be passed before the subcommand (for example, railway volume files --volume data browse /).
Argument or flag Description [REMOTE_PATH]Directory path to list. Defaults to / --jsonOutput in JSON format
Argument or flag Description <REMOTE_PATH>Remote file or directory to download [LOCAL_PATH]Local destination. Defaults to the current directory --overwrite, --overrideReplace the local path if it already exists --concurrency <N>Concurrent file downloads when downloading a directory. Defaults to 32 --jsonOutput in JSON format
Argument or flag Description <LOCAL_PATH>Local file or directory to upload <REMOTE_PATH>Remote destination path --overwriteReplace the remote path if it already exists --concurrency <N>Concurrent file uploads when uploading a directory. Defaults to 32 --jsonOutput in JSON format
Argument or flag Description <REMOTE_PATH>Remote file to delete -y, --yesSkip confirmation --jsonOutput in JSON format
railway volume files delete refuses to run when invoked by an AI agent and must be run by a human.
Argument or flag Description <OLD_REMOTE_PATH>Existing remote path <NEW_REMOTE_PATH>New remote path --jsonOutput in JSON format
The volume file browser TUI can be opened with either:
railway volume browse [REMOTE_PATH] — top-level shortcutrailway volume files browse [REMOTE_PATH] — equivalent through the files group
Argument or flag Description [REMOTE_PATH]Directory path to open. Defaults to / -v, --volume <VOLUME>Volume ID or name to browse --editor <COMMAND>Editor command to use when editing files --concurrency <N>Concurrent file downloads. Defaults to 32
When using railway volume files browse, pass --volume on the files group (for example, railway volume files --volume data browse /). The --editor and --concurrency flags are passed on browse itself.