> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nx1cloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# put

> Upload a file or directory to a bucket.

The `put` command transfers a file into an S3 bucket.

```bash theme={null}
s3Cli put <local_path> <s3_path>
```

<Accordion title="Arguments">
  * `local_path` `string` **required**: Local path to a file.
  * `s3_path` `string` **required**: S3 bucket name.

  <Note>
    In the `s3_path`, don't include prefixes such as `s3://`, `s3a://`, and `s3n://`.
    Only specify the bucket name.
  </Note>
</Accordion>

<Accordion title="Option">
  * `--recursive` `-r` **optional** Uploads a directory recursively.
</Accordion>

<Accordion title="Global options">
  * `--help` `-h` **optional**: Shows help messages and exits.
  * `--config` `-c` `string` **optional**: Path to Hadoop's `core-site.xml` file.
  * `--jceks-dir` `-j` `string` **optional**: Directory containing JCEKS files.
  * `--ranger-classpath` `-r` `string` **optional**: Path to Ranger's JAR files.
  * `--user` `-u` `string` **optional**: Username for Ranger authorization.
  * `--verbose` `-v` **optional**: Verbose logging.
</Accordion>