Hey! These docs are for version 1.0, which is no longer officially supported. Click here for the latest version, 1.2!

Edge Caching

Edge Caching Rules allow you to control how long assets stay close to your users, all across the world. Edge cached assets will be immediately available for use with minimal time required to fetch them. You can use Edge Caching rules to reduce latency, achieve better throughput and provide higher availability.

Create an Edge Caching Rule

To create new Edge Caching rules, click "Edge Caching" on the left-hand repository menu and then click the green "Create Rule" button:

Edge Caching Create Rule buttonEdge Caching Create Rule button

Edge Caching Create Rule button

You will then be presented with the Create Edge Caching Rule form, this is where you define your cache rule parameters:

Create Edge Caching Rule FormCreate Edge Caching Rule Form

Create Edge Caching Rule Form

Form Fields



Package Format

The package format that you want this cache rule to apply to


The file path pattern that this cache rule applies to. Patterns may consist of alphanumeric characters and the Glob (*) character used to wildcard match.

Please be aware that if this pattern covers repository metadata for a format, then new packages will not be visible until the TTL has expired.


By default, cache rules will be matched in the order they were created. Setting a Priority allows you to augment or override this behaviour. Rules with higher priority values take precedence.


The TTL (Time-To-Live) associated with this cache rule (in seconds). Packages that are matched to this rule will be cached at the content distribution network for this number of seconds. Please select TTL values with care as we do not currently offer a way to request a cache invalidation (although that will be coming soon!).


Our default TTL values are 60s for metadata and 600s for packages.

Once you have defined your cache rule parameters, click the green "+ Create Rule" button to create and apply the rule:

Pattern Examples

Match all file paths containing "cloudsmith":


Match all .gz files:


Match all SNAPSHOT jar packages:


Edit an Edge Caching Rule

To edit an Edge Caching Rule, click the blue "Edit" button on the cache rule you wish to modify:

Edge Caching Edit ButtonEdge Caching Edit Button

Edge Caching Edit Button

You are then presented with the Edit Rule form:

Once you have modified the parameters of the cache rule, click the blue "Edit" button to apply your changes.

Delete an Edge Caching Rule

To delete an Edge Caching rule, click the red "Delete rule" button on the cache rule you wish to delete:

You will then be presented with a form asking you to confirm the deletion of the cache rule:

Edge Caching Rule Delete FormEdge Caching Rule Delete Form

Edge Caching Rule Delete Form

Click the red "Confirm Delete" button to delete the rule.

Did this page help you?