Skip to content
runlot

CLI

Check storage usage, turn storage off and back on. CLI commands for uploading and downloading files directly aren't available yet.

runlot storage [status] [dir]    Check usage and limits (--json prints the raw data)
runlot storage delete [dir]      Remove storage (requires admin)
runlot storage on [dir]          Turn it back on

Every project has storage from the start. runlot storage delete turns it off and it stays off — a later deploy does not bring it back — until runlot storage on.

Check status

runlot storage status
runlot storage status --json

Remove storage

runlot storage delete

This command requires the admin role and asks for confirmation.

What the CLI doesn't do yet

Commands that manage files directly, such as ls, cp, and rm, aren't available yet. For now, manage your files from your worker with env.storage or by generating a signed URL.

If you need a stopgap admin tool, you can add an admin route to your worker and use access control so that only organization admins can reach it.

app.get("/admin/files", async (c) => {
  const who = identity(c.req.raw);
  if (who.orgRole !== "admin") return new Response(null, { status: 403 });
  const page = await c.env.storage.list({ limit: 1000 });
  return Response.json(page.objects);
});

On this page