Invalid type passed!
Received:
{type}
Expected one of:
{asideVariants.join(", ")}
: <>
{title &&
{title}
}
{children}
}
;
};
`storage-daemon` downloads and shares TON Storage bags. `storage-daemon-cli` is the console client used to control it.
## Prerequisites
* Linux, macOS, or Windows host with at least a dual-core 1 GHz CPU, 2 GB RAM, 2 GB SSD (plus space for bags), and stable 10 Mb/s bandwidth with a public/static IP
* Global network config file, for example `global.config.json` from the [TON configs](https://ton-blockchain.github.io/)
## Install storage-daemon
* Download prebuilt `storage-daemon` and `storage-daemon-cli` binaries from [TON auto builds](https://github.com/ton-blockchain/ton/releases/latest) (built from the `testnet` branch).
* Or build from source in the [`ton-blockchain/ton`](https://github.com/ton-blockchain/ton/tree/testnet) repository (target: `storage-daemon` and `storage-daemon-cli`).
## Start the daemon
Run the daemon with explicit ports and a data directory:
```bash theme={null}
storage-daemon -v 3 -C global.config.json -I :3333 -p 5555 -D storage-db
```
* `-v` — log verbosity (`3` = INFO)
* `-C` — path to the global network config
* `-I` — ADNL listen IP and port (`` is the public or reachable address of the host)
* `-p` — TCP port for the console interface
* `-D` — path to the daemon database; CLI keys are generated inside the `cli-keys/` subdirectory on first start
## Connect with storage-daemon-cli
Point the CLI at the console port and keypair generated by the daemon:
```bash theme={null}
storage-daemon-cli -I 127.0.0.1:5555 -k storage-db/cli-keys/client -p storage-db/cli-keys/server.pub
```
* `-I` — daemon host and console port
* `-k` — client private key path
* `-p` — server public key path (CLI option, not a port)
`storage-daemon-cli` can also run non-interactively:
```bash theme={null}
storage-daemon-cli ... -c "add-by-meta bag-meta.bag" -c "list --hashes"
```
## Add bags for download
Download by bag ID hash or by meta file:
```bash theme={null}
add-by-hash -d
add-by-meta -d
```
* `` — 64-character hex bag ID
* `` — target directory for downloaded files
* `` — path to the bag meta file
* If `-d` is omitted, files are saved to the daemon's default storage directory.
`list` shows added bags; `list --hashes` prints full IDs. Use either the numeric ordinal from `list` (valid only for the current session) or the full ID in other commands.
### Inspect and control transfers
* `get ` — show description, size, speed, and file list
* `get-peers ` — list connected peers
* `download-pause ` / `download-resume ` — control downloads
* `upload-pause ` / `upload-resume ` — control uploads
* `remove ` — remove the bag
* `remove --remove-files ` — remove the bag and files (files are always removed if stored in the daemon's internal directory)
## Partial downloads and priorities
Download only selected files by setting priorities:
```bash theme={null}
add-by-hash -d --partial file1 file2
add-by-meta -d --partial file1 file2
```
Each file has a priority `0–255`; `0` disables download. `--partial` sets listed files to `1` and all others to `0`.
Update priorities after adding the bag:
* `priority-all ` — set the same priority for every file
* `priority-idx ` — set by file index from `get`
* `priority-name ` — set by file name
Priorities can be set before the full file list loads.
* `` — integer priority from `0` (do not download) to `255` (highest)
* `` — file index from the `get` output
* `` — file name from the `get` output
## Create and share a bag
Create a bag from a file or directory and start seeding:
```bash theme={null}
create -d "Description of the bag"
```
* `` — file or directory to include in the bag
Options:
* `--no-upload` — create the bag without uploading; enable later with `upload-resume`
* `--copy` — copy files into the daemon's internal directory before seeding
After creation the CLI prints the bag ID. Share the meta file if others need a `.torrent`-like descriptor:
```bash theme={null}
get-meta
```
* `` — path to save the generated meta file