Sections
Limits and questions
File sizes, quota, naming rules, retention periods, common questions and what each Artifactory error message means.
Limits
| What | Limit |
|---|---|
| Size of a single file | 5 GB |
| Agent upload in one request | 16 MB; larger — upload in parts (large: true) |
| Unfinished upload in parts | Lives for 24 hours |
Text reading by an agent (artifact_read_text) | 1 MB; larger — a download link |
| Download link | Lives for 5 minutes |
| Trash | 7 days, then the file is deleted for good |
| Description | 500 characters |
| Tags | Up to 50 per file, each up to 64 characters; empty ones and duplicates are dropped |
| Metadata (set by an agent) | Key up to 128 bytes, total up to 2 KB |
| File or folder name | Up to 255 bytes |
| Full folder path | Up to 1024 bytes |
| Image preview without a click | Up to 25 MB |
| Text and code preview | Up to 1 MB |
| PDF preview | Up to 30 MB |
Quota
The quota is how much space files can take. It includes all versions of files and the trash.
- The quota is currently 1 GB per organization owner's account, shared by all of that owner's organizations and projects. On screen this is labeled "The organization owner's account quota".
- Space is reserved when an upload starts. If a file doesn't fit, the upload won't start — no "uploaded 90% and failed".
- From 80% the indicator turns yellow: "Storage is more than 80% full". An agent sees the
same warning through
artifact_quota. - At 100% uploads are unavailable: "Quota exhausted — uploads are unavailable". On the web the check happens even before files are queued, based on the total size of the selected files: "Storage quota exhausted: {used} of {limit}. Free up space or change the plan."
- With the quota exhausted, everything else works: you can read, download, rename, move and delete files as usual.
How to free up space: the "Quota cleanup" case.
Naming rules
Not allowed:
- an empty name,
.and..; - the characters
/and\inside a file or folder name (they separate the path); - control characters;
- spaces at the start or end of the name.
Cyrillic, spaces inside the name and emoji are allowed. A folder can't contain two files or two subfolders with the same name. The root can't be deleted or moved.
Access
- Files are visible to all members of the organization that owns the project. Permissions are checked on every action: a person removed from the organization loses access immediately.
- There are no public links. A download link is issued for one file, lives for 5 minutes and is only good for the download itself.
- Another project is indistinguishable from a nonexistent one: a request to it returns "project not found".
Common questions
The menu has no "Artifactory" item. Artifactory is being enabled for accounts gradually — it hasn't been enabled for yours yet.
The screen says "File storage is not connected in this environment yet".
This Flownix server has no file storage. In such an environment the artifact_* tools respond
with "artifact storage is not configured on this server".
Why can't semantic search find my file? Search covers the name, folder, description and tags, but not the contents. Add a description — one or two sentences about what's in the file and why it exists. A new file enters the index within a few seconds; files in the trash don't show up in search.
How do I upload a new version of a file?
Upload a file with the same name to the same folder and choose "New version". An agent passes
new_version: true.
How do I go back to an old version? Download it from "Versions" and upload it as a new version — it becomes the latest, and the history is kept.
Can I delete a single version? No, only the whole file with all its versions.
Can I watch a video right on the screen? Not yet: video and audio can be downloaded; playback will come later.
Why won't a file delete? Tasks, documents or runs reference it. The dialog shows exactly which; you can delete it with the "Delete anyway" button — the references will then point to a deleted file.
A file won't restore from the trash. A file with the same name already sits in the original location. Rename or move it and try again.
Can I drag a file to another folder with the mouse? No, dragging only works for uploading from your system. To move files, use "Move".
Where's the description when uploading through the web? Uploading through the web doesn't ask for a description — add it in the properties panel right after uploading.
Error messages
| Message | What it means | What to do |
|---|---|---|
| name already exists in this folder | A file with that name already exists (an agent without new_version, or restoring to an occupied spot) | Upload as a new version, or rename or move the file in the way |
Quota exhausted — uploads are unavailable / plan_limit (artifact_storage) | The quota is full | Free up space: delete what you don't need, empty the trash |
| {name}: the file is larger than 5 GB | The file exceeds the limit | Split or compress it |
| artifact is in use by AF-TASK-1, …; repeat with confirm to delete anyway | The file is referenced | For an agent: repeat with confirm: true if the deletion is intentional |
| only an artifact in the trash can be purged; delete it first | "Delete forever" works only from the trash | Delete to the trash first |
| artifact is not in the trash | The file being restored isn't in the trash | Refresh the list |
| description is required… | An agent uploads without a description | Add a description |
| description is longer than 500 characters | The description is longer than 500 characters | Shorten it |
| at most 50 tags / tag "…" is longer than 64 characters | Too many tags or tags too long | Cut them down |
| content is larger than 16777216 bytes; use large=true | An agent sends more than 16 MB in one request | Upload in parts |
| sha256 does not match the content; the artifact was not created | The file was corrupted during upload | Upload it again |
| upload has expired; start a new one | An upload in parts wasn't finished within 24 hours | Start the upload again |
| AF-ARTF-N is larger than 1 MB… / not a text file / not valid UTF-8 text | An agent tries to read a large or binary file as text | Get a link through artifact_download_url |
| the root folder cannot be deleted | An attempt to delete the root | — |
| File storage is not connected in this environment yet. / artifact storage is not configured on this server | The server has no storage | Contact the environment administrator |