Files
Olares/docs/developer/develop/advanced/cli/olares-download.md
2025-07-17 11:58:59 +08:00

47 lines
3.6 KiB
Markdown

# `olares download`
## Synopsis
The `olares download` command downloads the necessary packages and components required to install Olares on your local machine. It supports downloading components, checking the status of installation packages, and fetching the manifest file.
```bash
olares-cli olares download [subcommand] [option]
```
## Subcommands
| Name | Shorthand | Usage | Example |
|-------------|-----------|-------------------------------------------------------|----------------------------------------|
| `check` | | Checks the status of the Olares installation package. | `olares-cli olares download check` |
| `component` | `c` | Downloads Olares components. | `olares-cli olares download component` |
| `wizard` | `w` | Downloads the manifest file. | `olares-cli olares download wizard` |
## Options
| Name | Shorthand | Usage |
|----------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `--base-dir` | `-b` | Sets the base directory for Olares.<br> Defaults to `$HOME/.olares`. |
| `--download-cdn-url` | | Sets the CDN accelerated download URL in the format `https://example.cdn.com`. <br>If not provided, the default URL will be used. |
| `--help` | `-h` | Displays help information. |
| `--kube` | | Specifies the Kubernetes type. <br>Supported types are `k3s` (default) and `k8s`. |
| `--version` | `-v` | Specifies the Olares version. <br>Version values follow the format `x.y.z` (e.g., `1.10.0`) or include a build date (e.g., `1.10.0-20241109`).<br> Refer to the [GitHub Releases page](https://github.com/beclab/Olares/releases) for available versions. |
## Examples
```bash
# Specifies the base directory where all downloaded components will be stored.
olares-cli olares download component -b /custom/path
# Specifies a CDN-accelerated URL for downloading Olares components.
olares-cli olares download component --download-cdn-url https://my.cdn.com
# Specifies the Kubernetes type for the installation.
olares-cli olares download component --kube k8s
# Sets the path to the package manifest file.
olares-cli olares download component --manifest /custom/path/manifest.json
# Specifies the version of Olares packages and components to download.
olares-cli olares download component -v 1.11.0
```