Install & Compatibility
Where this runs
tested against v5.4.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.496s · 128.4MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 11.6s · import 0.488s · 130MB
139MB installed
● package 139MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
client
✓ from zunclient import client
Initialize Zun client and list containers.
import os
from zunclient import client
# Create client using Keystone auth
auth_url = os.environ.get('OS_AUTH_URL', 'http://localhost:5000/v3')
project_name = os.environ.get('OS_PROJECT_NAME', 'admin')
username = os.environ.get('OS_USERNAME', 'admin')
password = os.environ.get('OS_PASSWORD', 'admin')
user_domain_name = os.environ.get('OS_USER_DOMAIN_NAME', 'Default')
project_domain_name = os.environ.get('OS_PROJECT_DOMAIN_NAME', 'Default')
kclient = client.Client(1, auth_url=auth_url,
username=username,
password=password,
project_name=project_name,
user_domain_name=user_domain_name,
project_domain_name=project_domain_name)
print('Containers:', list(kclient.containers.list()))
zun --version
Errors
Common errors & fixes
AttributeError: module 'zunclient' has no attribute 'client'
Importing incorrectly; the correct module is `zunclient.client`.
fixUse `from zunclient import client` (do not use `import zunclient` then `zunclient.client`).
zunclient.exceptions.EndpointNotFound
No Zun service endpoint found in Keystone catalog. The service may not be enabled, or the auth URL is wrong.
fixVerify OpenStack services are running and the service catalog contains a 'container' endpoint. Ensure env vars OS_AUTH_URL, OS_USERNAME, etc. are correct.
Upgrade
Version history
5.4.0latest on PyPI · released Feb 27, 2026
Audit
Dependencies
keystoneauth1requiredAuthentication for OpenStack APIs
osc-librequiredOpenStackClient common library