Build Artifacts
This document is intended for system administrators of self-hosted installations of CircleCI Server.
Build artifacts persist data after a job is completed. They can be used for longer-term storage of your build process outputs. For example, when a Java build/test process finishes, the output of the process is saved as a .jar file. CircleCI can store this file as an artifact, keeping it available long after the process has finished.
Safe and Unsafe Content Types
By default, only pre-defined artifact types are allowed. This protects users from uploading, and potentially executing malicious content. The 'allowed-list' is as follows:
| Category | Safe Type |
|---|---|
Text |
Plain |
Application |
json |
Image |
png |
Image |
jpg |
Image |
gif |
Image |
bmp |
Video |
webm |
Video |
ogg |
Video |
mp4 |
Audio |
webm |
Audio |
aac |
Audio |
mp4 |
Audio |
mpeg |
Audio |
ogg |
Audio |
wav |
Also, by default, the following types will be rendered as plain text:
| Category | Type |
|---|---|
Text |
html |
Text |
css |
Text |
javascript |
Text |
ecmascript |
Application |
javascript |
Application |
ecmascript |
Text |
xml |
Allow Unsafe Content types
If you would like to allow content types that are not included in the whitelist above, follow these steps:
-
Navigate to the CircleCI Management Console (for example,
<your-circleci-hostname>:8800/settings) and select Settings from the menu bar. -
Scroll down to find the Artifacts section.
-
Select Serve Artifacts with Unsafe Content-Types.
Figure 1. Allow Unsafe Content Types -
Click Save at the bottom of the page and Restart Now in the pop-up to save your changes and restart the console.
| Any change to the settings within the Management Console will incur downtime as the console will need to be restarted. |