---
title: Uploader
description: Use the raw uploader account flow for program binaries with thru uploader
source_url:
  html: https://thru.org/docs/cli-reference/uploader-commands/
  md: https://thru.org/docs/cli-reference/uploader-commands.md
---

# Uploader

Use `thru uploader` when you need the lower-level upload-buffer lifecycle rather than managed program operations.

## Use This When

- you want to upload a binary without going through the managed `program` flow
- you need to inspect or clean up uploader accounts directly

Choose another family when:

- you want the higher-level managed workflow: [Program Commands](https://thru.org/docs/cli-reference/program-commands.md)

## Commands

| Command | Use it for |
| - | - |
| `upload` | Upload a program binary through uploader accounts. |
| `cleanup` | Remove uploader-related accounts for a seed. |
| `status` | Inspect uploader account state for a seed. |

## High-Signal Flags

| Flag | Why it matters |
| - | - |
| `--uploader` | Override the configured uploader program ID. |
| `--chunk-size` | Control chunk sizing for upload transactions. |

## Minimal Pattern

```bash
thru uploader upload my_program ./build/thruvm/bin/my_program_c.bin
thru uploader status my_program
```

## Notes

- Prefer `program create` or `program upgrade` for most app-facing deployment tasks.
- Use `cleanup` when a previous upload left partial uploader state behind.