> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xloud.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Service Administration

> Configure image storage backends, metadata schemas, caching, and access policies for Xloud Image Service.

<p style={{ fontSize: '1.25rem', fontWeight: 700, marginBottom: '0.75rem' }}>Overview</p>

The Xloud Image Service administration guide covers every operational concern for running
the image service in production — from selecting and configuring the storage backend to
securing the image catalog, defining metadata schemas, and tuning the image cache for
optimal instance launch performance.

<Warning>
  **Administrator Access Required** — This operation requires the `admin` role. Contact your
  Xloud administrator if you do not have sufficient permissions.
</Warning>

***

<CardGroup cols={4}>
  <Card title="Architecture" icon="network" href="/services/images/architecture" color="#197560">
    Service topology, storage backend options, and data flow for the Image Service.
  </Card>

  <Card title="Storage Backends" icon="database" href="/services/images/storage-backends" color="#197560">
    Configure Xloud Distributed Storage (RBD), file store, or object storage as the image backend.
  </Card>

  <Card title="Image Import" icon="cloud-download" href="/services/images/image-import" color="#197560">
    Use the web-download and chunked upload import APIs for large-scale image ingestion.
  </Card>

  <Card title="Metadata Definitions" icon="tag" href="/services/images/metadata" color="#197560">
    Define structured metadata namespaces for consistent image property schemas.
  </Card>

  <Card title="Image Cache" icon="zap" href="/services/images/image-cache" color="#197560">
    Configure per-node image caching to reduce instance launch times.
  </Card>

  <Card title="Quotas" icon="gauge" href="/services/images/quotas" color="#197560">
    Enforce per-project image count and storage size limits.
  </Card>

  <Card title="Security" icon="shield" href="/services/images/image-security" color="#197560">
    Configure image signing, property protections, and public image access controls.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/services/images/admin-troubleshooting" color="#197560">
    Diagnose storage backend failures, API errors, and cache performance issues.
  </Card>
</CardGroup>

***

<p style={{ fontSize: '1.25rem', fontWeight: 700, marginBottom: '0.75rem' }}>Quick Reference</p>

| Task                             | Command                                          |
| -------------------------------- | ------------------------------------------------ |
| Check Image API container status | `docker ps --filter name=glance`                 |
| View Image API logs              | `docker logs glance_api --tail 100`              |
| List all images (admin)          | `openstack image list --all-projects`            |
| Show image quota for project     | `openstack quota show --project <name>`          |
| Verify RBD pool exists           | `ceph osd pool ls \| grep images`                |
| Trigger cache pre-fetch          | `docker exec glance_api glance-cache-prefetcher` |

***

<p style={{ fontSize: '1.25rem', fontWeight: 700, marginBottom: '0.75rem' }}>Next Steps</p>

<CardGroup cols={4}>
  <Card title="Image User Guide" icon="book-open" href="/services/images/user-guide" color="#197560">
    Day-to-day operations — uploading images, snapshots, and sharing.
  </Card>

  <Card title="Identity Admin Guide" icon="fingerprint" href="/services/identity/admin-guide" color="#197560">
    Manage authentication backends and access policies governing image operations.
  </Card>
</CardGroup>