---
id: python-manilaclient
version: "6.2.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# python-manilaclient — Client library for OpenStack Shared File System Storage

License: permissive · Maintenance: active · Downloads: 217.0K/mo

## What it is and what it does

python-manilaclient is the official Python client library for OpenStack Manila, the shared file system storage service. It provides both a programmatic Python API (the manilaclient module) and a command-line interface (manila command) that expose the full OpenStack Manila API for managing file shares, snapshots, and related resources.

The package is built on top of OpenStack's standard libraries (oslo.config, oslo.log, keystoneauth1) and integrates with the OpenStack CLI framework via osc-lib. It requires Python 3.10 or later and is actively maintained as part of the OpenStack project. Typical use cases include automating share provisioning, querying share metadata, managing access rules, and integrating Manila operations into larger infrastructure-as-code workflows.

Use it for:

- Automate provisioning and lifecycle management of shared file systems in OpenStack environments via Python scripts.
- Query and monitor existing shares, snapshots, and access rules from the command line or programmatically.
- Integrate Manila storage operations into Ansible playbooks or other infrastructure automation tools.
- Build custom applications that need to create, modify, or delete shares and manage share access policies.
- Retrieve share metadata and availability information for capacity planning or multi-cloud orchestration.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings and a command-line tool to interact with the OpenStack Manila shared file system storage API, implementing the full API surface for programmatic and shell-based operations.

Yes, if you are working with OpenStack Manila. The package is actively maintained, has low install friction, carries no licensing restrictions, and implements the complete Manila API. Install it when you need to automate or script interactions with OpenStack shared file system storage, either through the CLI or Python API.

## Install

pip install python-manilaclient
uv add python-manilaclient
poetry add python-manilaclient

## Installing python-manilaclient

Before you install: Low install friction with a pure-Python wheel. Active maintenance status with a recent release (44 days ago). Depends on established OpenStack libraries (oslo.*, keystoneauth1, requests) and standard utilities, all widely used in production OpenStack deployments.

License in practice: Licensed under Apache License 2.0 (permissive). No restrictions on commercial or proprietary use; you may modify and redistribute under the same license terms.

Quickstart:

pip install python-manilaclient

from manilaclient.v2 import client
nt = client.Client("2", USER, PASS, PROJECT, AUTH_URL, service_type="share")
nt.shares.list()

Requires Python 3.10 or later. OpenStack Keystone authentication endpoint (OS_AUTH_URL) and credentials must be configured via environment variables or parameters.

Verify before relying:

- Whether the package works with all current OpenStack releases or only specific versions.
- Performance characteristics and scalability limits when managing large numbers of shares or snapshots.
- Compatibility with non-Keystone authentication methods or custom identity providers.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 217.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

openstack manila client, shared file system storage api, openstack file sharing, manila command-line tool, openstack storage client, file system provisioning openstack, manila python api, openstack, storage-client, file-sharing

[View on SkillFed](https://skillfed.io/packages/python-manilaclient) · [View on PyPI](https://pypi.org/project/python-manilaclient/)