pgadmin4/docs/en_US/storage_manager.rst

.. _storage_manager:

************************
`Storage Manager`:index:
************************

*Storage Manager* is a feature that helps you manage your systems storage device. You can use *Storage Manager* to:

* Download, upload, or manage operating system files. To use this feature, *pgAdmin* must be running in *Server Mode* on your client machine.
* The shared storage option allows users to access the shared storages that are shared by admin users.
* Download *backup* or *export* files (custom, tar and plain text format) on a client machine.
* Download *export* dump files of tables.

You can access *Storage Manager* from the *Tools* Menu.

.. image:: images/storage_manager.png
    :alt: Storage Manager
    :align: center

Use icons on the top of the *Storage Manager* window to manage storage:

Use the ``Folder`` icon |Shared Storage| to access shared storage. In order to enable shared storage,
admins need to add the SHARED_STORAGE variable to the config file. Users can access the shared storage
with this and share files with one another.

.. |Shared Storage| image:: images/sm_ss.png

Use the ``Home`` icon |home| to return to the home directory.

.. |home| image:: images/sm_home.png

Use the ``Up Arrow`` icon |uparrow| to return to the previous directory.

.. |uparrow| image:: images/sm_go_back.png

Use the ``Refresh`` icon |refresh| to display the most-recent files available.

.. |refresh| image:: images/sm_refresh.png

Select the ``Download`` icon |download| to download the selected file.

.. |download| image:: images/sm_download.png

Use the ``New Folder`` icon |folder| to add a new folder.

.. |folder| image:: images/sm_new_folder.png

Use the *Format* drop down list to select the format of the files to be displayed; choose from *sql*, *csv*, or *All Files*.

Shared Storage
*********************
.. image:: images/shared_storage.png
    :alt: Other options
    :align: center

In shared storage the ``My Storage`` is the user's storage directory, and other directories are shared storage set by
the admin user. Using this shared storage users can share the files with other users through pgAdmin.
Admin users can mark the shared storage as restricted to restrict non-admin users from deleting, uploading,
adding, and renaming files/folders in shared storage by setting the restricted_access flag in config.

Other Options
*********************

.. image:: images/sm_options.png
    :alt: Other options
    :align: center

.. table::
   :class: longtable
   :widths: 1 5

   +----------------------+---------------------------------------------------------------------------------------------------+
   | Menu                 | Behavior                                                                                          |
   +======================+===================================================================================================+
   | *Rename*             | Click the *Rename* option to rename a file/folder.                                                |
   +----------------------+---------------------------------------------------------------------------------------------------+   
   | *Delete*             | Click the *Delete* option to rename a file/folder.                                                |
   +----------------------+---------------------------------------------------------------------------------------------------+
   | *Upload*             | Click the *Upload* option to upload multiple files to the current folder.                         |
   +----------------------+---------------------------------------------------------------------------------------------------+
   | *List View*          | Click the *List View* option to to display all the files and folders in a list view.              |
   +----------------------+---------------------------------------------------------------------------------------------------+
   | *Grid View*          | Click the *Grid View* option to to display all the files and folders in a grid view.              |
   +----------------------+---------------------------------------------------------------------------------------------------+
   | *Show Hidden Files*  | Click the *Show Hidden Files* option to view hidden files and folders.                            |
   +----------------------+---------------------------------------------------------------------------------------------------+


You can also download backup files through *Storage Manager* at the successful completion of the backups taken through :ref:`Backup Dialog <backup_dialog>`, :ref:`Backup Global Dialog <backup_globals_dialog>`, or :ref:`Backup Server Dialog <backup_server_dialog>`.

At the successful completion of a backup, click on the icon to open the current backup file in *Storage Manager* on the *process watcher* window.

.. image:: images/process_watcher_storage_manager.png
    :alt: Process watcher with storage manager icon
    :align: center