Files
Upload and manage app binaries and test files.
Overview
The Files page serves as your file repository for Device Farm. Upload app binaries (APK, IPA, AAB)
for installation and test data files for your automation scripts. Files can be referenced in Appium
capabilities using the df:// URL scheme.
Supported File Types
App Binaries
Mobile application packages for installation on devices.
| Extension | Description |
|---|---|
| .apk | Android Package |
| .ipa | iOS App Store Package |
| .aab | Android App Bundle |
| .app | macOS App Bundle (auto-zipped) |
Other Files
Test data, media, and configuration files.
| Extension | Description |
|---|---|
| .json | Test data, config |
| .csv | Data files |
| .png/.jpg | Image assets |
| .zip | Archives |
Uploading Files
Upload files using any of these methods:
Drag & Drop
Drag files directly onto the Files page. A drop zone will appear when hovering over the page. Multiple files can be dropped at once.
Upload Button
Click the "Upload Files" button in the header to open the file picker. Select one or more files to upload.
.app Bundle Support
Drag a macOS .app bundle directly - it will be automatically converted to a ZIP file before upload. Progress shows both zipping and upload stages.
Upload Progress
A progress bar shows upload status. Large files may take time depending on your connection speed. You can cancel an upload in progress.
Limits & Storage
File upload and storage limits based on your plan:
| Limit Type | Value |
|---|---|
| Maximum file size | 5 GB per file |
| Total storage | Based on your plan quota |
| File retention | Files are retained indefinitely while active |
| Concurrent uploads | Up to 5 files simultaneously |
Storage Quota Check your current storage usage in the Dashboard or Settings page. Delete unused files to free up space when approaching your limit.
Using Files in Automation
Reference uploaded files in your Appium capabilities using the df:// URL scheme:
{
"platformName": "Android",
"appium:automationName": "UiAutomator2",
"appium:app": "df://your-file-uuid-here",
"df:apiKey": "your-api-key"
}
Finding the File ID
Click on any file card to view its details. The file ID (UUID) is shown in the details panel and can be copied with one click.
Config Generator Use the Config Generator to select files
from a dropdown and automatically generate capabilities with the correct df:// URL.
Filtering & Search
Category Tabs
Filter by category: "Apps" shows APK/IPA/AAB binaries, "Files" shows all other file types.
| Tab | Shows |
|---|---|
| All | All uploaded files |
| Apps | APK/IPA/AAB binaries |
| Files | All other file types |
Search
Search by file name. Results filter as you type.
Type Filter
Use the filter button to show only specific file types (APK, IPA, etc.).
File Actions
| Action | Description |
|---|---|
| Download | Download the file to your computer |
| Install | Install app on a device (requires active test) |
| Delete | Permanently remove the file from storage |
File Card Details
Each file card displays:
| Field | Description |
|---|---|
| File Name | Original filename as uploaded |
| Type Badge | APK, IPA, AAB, or file extension |
| Size | File size in human-readable format |
| Uploaded | Upload timestamp (relative or absolute) |
| Platform | iOS or Android (for app binaries) |
Statistics
The header shows quick stats about your file repository:
- Total Files - Number of files in your library
- APK - Android app count
- IPA - iOS app count
- Other - Other file types count
