FastPanel Registry — Container Image Hosting

← Back

Retention Policies: Keep Your Registry Clean

2026-02-22

Docker images accumulate fast. Without a cleanup strategy, your registry storage grows indefinitely. FastPanel Registry lets you define retention policies that run automatically.

registry.fastpanel.app/policies
team/api-service
Keep last 10 tags · Delete untagged after 7d · Protect tags matching v*.*.*
team/frontend
Keep last 5 tags · Delete untagged after 3d · Protect tags matching release-*

Tag-based retention

Keep the last N tags matching a pattern:

retention:
  rules:
    - tag_pattern: "main-*"
      keep_last: 10
    - tag_pattern: "pr-*"
      keep_last: 3
    - tag_pattern: "release-*"
      keep_last: 50

Age-based retention

Delete images older than a specified duration, except those matching protected tags:

retention:
  rules:
    - max_age: "30d"
      except_tags: ["latest", "stable", "production"]

Untagged image cleanup

Enable automatic cleanup of untagged (dangling) images in your registry settings. Untagged images are safe to delete — if you're pushing frequently, they accumulate quickly.

Policies run nightly at 02:00 UTC. You can trigger a manual run from the registry settings page.