File Details
View and manage a single file. The header shows the file name and a short description. Files are uploaded once or pointed at an external URL, then referenced by images at build time. See Files for the list view.
Settings
Section titled “Settings”Editable fields:
- Name
- Description
The source is fixed after the file is created. It is shown read-only here:
- Uploaded file: the original upload. The uploader is disabled on this page, so you cannot replace the file content.
- External URL: for files that point at a remote resource. The URL field is disabled on this page.
A file is either an upload or an external URL, chosen when the file is created. The content type and size are recorded automatically and are not edited from this form. An external URL is fetched each time an image that uses it is built; on a normal (Docker-based) build it may point at a plain file or a Git repository. See the Files section on Create Image for how each source is placed into the image.
Save is enabled once you change a field. Editing requires modify access. Admins and the file creator always have it; other users need the Modify permission.
Permissions
Section titled “Permissions”Grant or revoke per-user access to the file. Each user row carries three flags:
- View: see the file.
- Modify: edit the file.
- Delete: remove the file.
Admins and the file creator always have full access. A file still used by an image cannot be deleted. See Permissions and access control.
Delete
Section titled “Delete”Delete the file from a confirmation form. You must type the file name to confirm. The section shows the form only when you hold delete permission; otherwise it shows a no-permission message.
A file cannot be deleted while it is referenced by an image. The server rejects the request with a conflict, and the page reports that the file is still in use. Remove the file from any image that uses it first, then delete it.