Skip to content
Trailer.devDocumentation

Search is only available in production builds. Try building and previewing the site to test it out locally.

Create File

The Create File form showing the upload and external URL type tabs.

Add a file to the archive so it can be included in image builds.

  • Name: required.
  • Description: optional.
  • Type: choose Upload or External with the tab selector.
    • Upload: select a file to upload. Maximum size is 5 MB.
    • External: enter a URL. It must be a valid URL.

An External file is not stored by Trailer; the URL is fetched each time an image that uses it is built. On a normal (Docker-based) image build the URL can point at a plain file (downloaded as-is) or a Git repository (cloned), and uploaded tar archives are unpacked at their destination. See the Files section on Create Image for the full behavior.

The file type and its content (the uploaded file or the URL) are set at creation only. On the details page they are read-only; you can change the name and description.

Grant other users access to the file. Each permission row has three flags:

  • View: see and use the file.
  • Modify: edit the file.
  • Delete: remove the file.

See Permissions and access control for the full model.