[[urls]]= Cockpit URLsCockpit URLs follow a specific structure, related to the components theyare loading. Various components are loaded in `+<iframe>+` tags. TheURLs for these components are described first. Further down below youcan find information about the top level bookmarkable Cockpit addressURLs.[[urls-components]]== Component URLsCockpit components are HTML documents. They are organized intoxref:packages.adoc[packages]. Each package contains information about whichHTML components are available in that package. Components should alwaysuse relative URLs to access resources, such as images, scripts or CSSfiles, even if they refer to a resource in another package.The following are valid component URLs, each bit will be discussedbelow:..../cockpit/@localhost/package/component.html#/hash/cockpit/$checksum/package/component.html#/hash/cockpit/@server.example.com/package/component.html#/hash/cockpit+embedder/@localhost/package/component.html#/hash....All resource URLs are under the `+/cockpit+` namespace. In cases where aCockpit component is being xref:embedding.adoc[embedded] the `+/cockpit+`may be followed by a plus sign and another `+embedder+` specificidentifier.What follows is either a `+@host+` or `+$checksum+` which tells cockpitwhere to xref:packages.adoc[find the package]. Checksums are used when morethan one host has identical packages and the resources can be cached.The `+package+` name is next, followed by the `+component+` HTML pathinside that package. And lastly a hash allows for navigation within asingle component. The hash should follow a URL path and/or query stringform.[WARNING]====Never assume that the `+@host+` or `+$checksum+` portion is predictable.Only refer to resources in packages on the same host.====[[urls-visible]]== Visible URLsThe above Component URLs are usually not visible to the user. Insteadthe Cockpit Web Service wraps the components in a shell which allowsnavigation, and provides bookmarkable clean URLs to the component. TheseURLs do not affect xref:embedding.adoc[embedders] orxref:packages.adoc[components] directly.If no path is present then the Cockpit will redirect to the default pagefor the server.If the first segment of the path begins with an `+@+` sign, then thecomponent is being shown from a non-local host.The next segment of the path, (or first if the component is being shownon the local host) is the xref:packages.adoc[package name]. The remainder ofthe path is a component file in the package. If no further path segmentsare present, a default `+index.html+` component in the package isloaded. An extension of `+.html+` is automatically appended.The hash portion of the path is automatically transferred to thecomponent as the hash of its link:#urls-components[resource URL].