---
name: "bepasty-object"
section: "1"
platform: "linux"
package: "bepasty"
version: "1.2.1-1+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/bepasty-object"
---

# bepasty-object(1)

Manage objects stored by bepasty

## NAME

bepasty-object - Manage objects stored by bepasty

## SYNOPSIS

bepasty-object \[-h\] \[--config CONFIG\] {migrate,purge,consistency,info,set} ... NAME \[NAME ...\]

## DESCRIPTION

bepasty-object operates on objects stored in the bepasty storage.

All commands expect either a **--config \<configfilename\>** argument or that the **BEPASTY\_CONFIG** environment variable points to your configuration file.

## OPTIONS

- **-h, --help**

  show this help message and exit

- **--config** *CONFIG*

  bepasty configuration file

## COMMANDS

### migrate

migrate object to the current metadata schema, in case of a bebasty upgrade.

Run as:

```
bepasty-object migrate '*'
```

Note: the ‘\*’ needs to be quoted with single-quotes so the shell does not expand it. it tells the command to operate on all names in the storage (you could also give some specific names instead of ‘\*’).

### purge

Purge objects from the database; multiple conditions are ANDed together.

- **-D, --dry-run**

  do not remove anything, just display what would happen

- **-A** *PURGE\_AGE,* **--age** *PURGE\_AGE*

  only remove if upload older than PURGE\_AGE days

- **-I** *PURGE\_INACTIVITY,* **--inactivity** *PURGE\_INACTIVITY*

  only remove if latest download older than PURGE\_INACTIVITY days

- **-S** *PURGE\_SIZE,* **--size** *PURGE\_SIZE*

  only remove if file size \> PURGE\_SIZE MiB

- **-T** *PURGE\_TYPE,* **--type** *PURGE\_TYPE*

  only remove if file mimetype starts with PURGE\_TYPE

### consistency

Run consistency checks.

- **-C, --compute**

  compute missing hashes and write into metadata

- **-F, --fix**

  write computed hash/size into metadata

- **-R, --remove**

  remove files with inconsistent hash/size

### info

Display information about objects.

### set

Set flags on objects.

\-L, --lock -l, --unlock -C, --incomplete -c, --complete

## ENVIRONMENT

- **BEPASTY\_CONFIG**

  Absolute path to a bepasty configuration file

## SEE ALSO

- •

  Bepasty documentation \<https://bepasty-server.readthedocs.io/en/latest/\>
