---
name: "z-push-admin"
section: "1"
platform: "linux"
package: "z-push-common"
version: "2.4.5-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/z-push-admin"
---

# z-push-admin(1)

device and user administration for Z-push

## NAME

z-push-admin — device and user administration for Z-push

## SYNOPSIS

**z-push-admin -a *list* \[-u *USER* \| -d *DEVICE*\]**

**z-push-admin -a *lastsync***

**z-push-admin -a *wipe* -u *USER* \| -d *DEVICE*\|-u *USER* -d *DEVICE***

**z-push-admin -a *remove* -u *USER* \| -d *DEVICE* \| -u *USER* -d *DEVICE***

**z-push-admin -a *resync* -t *TYPE* \| -t *TYPE* -u *USER* \| -t *TYPE* -u *USER* -d *DEVICE***

**z-push-admin -a *resync* -t *FOLDERID* -u *USER***

**z-push-admin -a *resync* -t *hierarchy* -u *USER* -d *DEVICE***

**z-push-admin -a *clearloop* \[-d *DEVICE* \| -d *DEVICE* -u *USER*\]**

**z-push-admin -a *fixstates***

## DESCRIPTION

**z-push-admin** can be used to manage the users and devices that sync their email, contacts and calendar items with Z-push.

## OPTIONS

### list

The *list* action lists synchronized devices. When no extra options are given, the command returns a listing of all synchronized devices. If the selection is narrowed by specifying a username (**-u** *USER*) or a device id (**-d** *DEVICE*) or both, the command lists extended information about the selected device(s).

### lastsync

The *lastsync* action lists all devices and synchronized users and the time that the last synchronization took place.

### wipe

The *wipe* action sends the wipe command to the selected device. The device decides how to handle this command: some devices only remove the account from the device, other devices do a factory reset, or even empty the complete storage. Use with caution.

### remove

The *remove* action removes state data. When a username is specified (**-u** *USER*), the state data of all devices of that user is removed. When a device id is specified (**-d** *DEVICE*), the state data of all users for that device is removed. When both are specified, the state data is removed for a specific user on a specific device.

### resync

The *resync* action triggers a resynchronization of specific data. With the options, it is possible to select which data exactly is synchronized. When a username (**-u** *USER*) and device id (**-d** *DEVICE*) are specified, all data of this user on this device is resynchronized. By specifying a folder type (**-t** *TYPE*), only folders of this type are synchronized. Valid types are **email**, **calendar**, **contact**, **task**, **note** and **gab**.

The **-t** option can also be used to specify a folder id to resynchronize only a specific folder, or **hierarchy** to resynchronize the folder list.

### clearloop

The *clearloop* action clears the loop detection data, either for all users and devices, or (with **-d** *DEVICE* and **-u** *USER*) for a specific user on a specific device. Loop detection is Z-push's automatic mechanism for avoiding problems where a device requests the same item over and over again. With the clearloop action this mechanism is reset.

### fixstates

The *fixstates* action checks the state of all users and devices and fixes potential problems.

## SEE ALSO

https://wiki.z-hub.io/display/ZP/Tools:+z-push-admin