github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-system-reset.1.md (about)

     1  % podman-system-reset(1)
     2  
     3  ## NAME
     4  podman\-system\-reset - Reset storage back to initial state
     5  
     6  ## SYNOPSIS
     7  **podman system reset** [*options*]
     8  
     9  ## DESCRIPTION
    10  **podman system reset** removes all pods, containers, images and volumes.
    11  
    12  This command must be run **before** changing any of the following fields in the
    13  `containers.conf` or `storage.conf` files: `driver`, `static_dir`, `tmp_dir`
    14  or `volume_path`.
    15  
    16  `podman system reset` reads the current configuration and attempts to remove all
    17  of the relevant configurations. If the administrator modified the configuration files first,
    18  `podman system reset` might not be able to clean up the previous storage.
    19  
    20  ## OPTIONS
    21  #### **--force**, **-f**
    22  
    23  Do not prompt for confirmation
    24  
    25  #### **--help**, **-h**
    26  
    27  Print usage statement
    28  
    29  ## EXAMPLES
    30  
    31  ### Switching rootless user from VFS driver to overlay with fuse-overlayfs
    32  
    33  If the user ran rootless containers without having the `fuse-overlayfs` program
    34  installed, podman defaults to the `vfs` storage in their home directory. If they
    35  want to switch to use fuse-overlay, they must install the fuse-overlayfs
    36  package. The user needs to reset the storage to use overlayfs by default.
    37  Execute `podman system reset` as the user first to remove the VFS storage. Now
    38  the user can edit the `/etc/containers/storage.conf` to make any changes if
    39  necessary. If the system's default was already `overlay`, then no changes are
    40  necessary to switch to fuse-overlayfs. Podman looks for the existence of
    41  fuse-overlayfs to use it when set in the `overlay` driver, only falling back to vfs
    42  if the program does not exist. Users can run `podman info` to ensure Podman is
    43  using fuse-overlayfs and the overlay driver.
    44  
    45  ## SEE ALSO
    46  `podman(1)`, `podman-system(1)`, `fuse-overlayfs(1)`, `containers-storage.conf(5)`
    47  
    48  ## HISTORY
    49  November 2019, Originally compiled by Dan Walsh (dwalsh at redhat dot com)