Stay organized with collections
Save and categorize content based on your preferences.
This page describes the high-level procedure for ordering, installing, and
returning Transfer Appliance. It includes the expected interactions
between you and Google.
Before you begin
Before ordering, use the following checklist to
ensure that your environment supports using Transfer Appliance.
Files are regular files or Unix-style hidden files. Unix-style hidden
files start with a . character.
Folders contain files. Empty folders are not created in
Cloud Storage, because objects don't reside within subdirectories
within a Cloud Storage bucket.
The maximum path length is 1024 bytes, which includes the optional
object prefix specified when you
provide Transfer Appliance Team with bucket configuration details.
Prepare for the appliance
To prepare for Transfer Appliance, do the following:
When you're ready to transfer your data,
apply for Transfer Appliance
from the same Google Cloud project as your destination Cloud Storage
bucket. You must have the required permissions
on the project to successfully apply for the Transfer Appliance.
When applying for Transfer Appliance, you can choose to use
your appliance in either offline mode or online mode.
Offline mode allows you to copy data to the appliance. When the appliance
is full, you send the appliance back to us.
Online mode enables streaming data copied to the appliance to your
Cloud Storage bucket.
If you select online mode, you can toggle
between offline and online mode once you have the appliance. If you
select offline mode, you cannot toggle modes once you receive your
appliance.
Before connecting the appliance to your network, validate that it hasn't
been tampered with during
shipping and
submit the Transfer Appliance Attestation Passcode returned by the appliance in the appliance detail
page of the Google Cloud console.
If the device was not tampered with during shipping, the credentials will be
displayed in the Google Cloud console. Otherwise, the Google Cloud console will show
an error message. If you encounter this error, contact the
Transfer Appliance Team at data-support@google.com
for assistance.
After receiving login credentials from Google Cloud console, do the
following:
If you selected an online-capable appliance and enabled online copy on
the appliance: The appliance streams the data you copy to the appliance
to your Cloud Storage bucket. Files and empty directories are
deleted from the appliance after they're successfully copied to your
Cloud Storage bucket.
If you selected an offline-only device or disabled online copy on the
appliance: After you complete all copying to the appliance,
finalize the copied data
to prepare for shipping.
Enter the passcode returned by the ta finalize command in the form
included in the email titled Google Transfer Appliance
Return Instructions sent by the Transfer Appliance Team.
To view the passcode again, run ta status.
The Transfer Appliance Team responds with the shipping label for the
Transfer Appliance for the given passcode.
Once you receive the shipping label, turn off the appliance and disconnect
all cables to it.
After returning the appliance, do the following to complete your transfer:
Verify that we received your appliance.
Transfer Appliance Team emails you when we receive your appliance at our data
transfer center. We'll start transferring data from the appliance to the
destination Cloud Storage bucket indicated in
the appliance order form.
Verify that we completed your transfer.
Transfer Appliance Team emails you when we've completed transferring data from
the appliance to your Cloud Storage bucket.
Validate your data in the
destination Cloud Storage bucket to verify that your data
transferred as you expected. We recommend that you don't delete
your source data until you verify that it successfully transferred to your
Cloud Storage bucket.
Data that's been transferred from your appliance is displayed in your
Cloud Storage bucket.
The following additional directories are created:
A storage-transfer directory that contains your Storage Transfer Service
logs.
A transferappliance directory that logs successful and failed
transfers from the appliance.
Sometimes, a cloud-ingest directory that is used to coordinate
the data uploaded from the appliance to your destination
Transfer Appliance bucket.
You can delete these directories once your data transfer is complete and
the data is fully available in your Transfer Appliance bucket.
Optional: You may request a Transfer Appliance wipe certificate to
verify that we've securely wiped all data after copying it to
Cloud Storage. If you're interested in a wipe certificate, contact
Transfer Appliance Team.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# High-level overview\n\nThis page describes the high-level procedure for ordering, installing, and\nreturning Transfer Appliance. It includes the expected interactions\nbetween you and Google.\n\nBefore you begin\n----------------\n\nBefore ordering, use the following checklist to\nensure that your environment supports using Transfer Appliance.\n\n- Review the\n [Transfer Appliance\n specifications](/transfer-appliance/docs/4.0/specifications) and\n confirm the following for your facility:\n\n - Power capabilities\n - Cooling capabilities\n - Physical space requirements\n- Identify the servers and the folders that contain data to transfer.\n\n- Confirm that employees performing the transfer have the correct permissions\n to access the data for the transfer.\n\n- Review that your data meets the following criteria:\n\n - Individual files are less than 5 terabytes (TB) in size.\n\n - File names follow [object naming guidelines](/storage/docs/objects#naming).\n\n - Files are regular files or Unix-style hidden files. Unix-style hidden\n files start with a `.` character.\n\n - Folders contain files. Empty folders are not created in\n Cloud Storage, because objects don't reside within subdirectories\n within a Cloud Storage bucket.\n\n - The maximum path length is 1024 bytes, which includes the optional\n object prefix specified when you\n provide Transfer Appliance Team with bucket configuration details.\n\nPrepare for the appliance\n-------------------------\n\nTo prepare for Transfer Appliance, do the following:\n\n- When you're ready to transfer your data,\n [apply for Transfer Appliance](https://console.cloud.google.com/transfer/appliance)\n from the same Google Cloud project as your destination Cloud Storage\n bucket. You must have the [required permissions](/transfer-appliance/docs/4.0/order-appliance#enable_required_permissions)\n on the project to successfully apply for the Transfer Appliance.\n\n- When applying for Transfer Appliance, you can choose to use\n your appliance in either offline mode or online mode.\n\n - Offline mode allows you to copy data to the appliance. When the appliance\n is full, you send the appliance back to us.\n\n - Online mode enables streaming data copied to the appliance to your\n Cloud Storage bucket.\n\n- If you select online mode, you can toggle\n between offline and online mode once you have the appliance. If you\n select offline mode, you cannot toggle modes once you receive your\n appliance.\n\nProject Setup and Key Download\n------------------------------\n\n1. Ensure you have the following permissions:\n\n - iam.serviceAccounts.getIamPolicy\n - resourcemanager.projects.getIamPolicy\n - resourcemanager.projects.setIamPolicy\n - storage.buckets.getIamPolicy\n - storage.buckets.setIamPolicy\n\n You will be able to get these required permissions through [custom roles](/iam/docs/creating-custom-roles)\n or [predefined roles](/iam/docs/understanding-roles). You can search for\n [predefined roles](/iam/docs/understanding-roles#predefined) for a given permission.\n2. Complete the project setup:\n\n 1. Go to [appliances page](https://console.cloud.google.com/appliances)\n 2. Find and select the appliance\n 3. Click on the `Open Setup Checklist` button\n 4. Complete the following steps:\n 1. `Enable API` will enable the required APIs for the appliance\n 2. `Authorize the service accounts` will create service accounts used for online transfer and authorize service accounts to the output bucket\n 3. (only for online transfer) [Create and Download](/transfer-appliance/docs/4.0/online-transfer#download-appliance-sa-key) the key of the appliance service account that is created during `Authorize the service accounts`\n\nReceive the appliance\n---------------------\n\nTo receive an appliance, follow these steps:\n\n1. Track the appliance shipped to you. We'll email you when it is delivered to\n your shipping address.\n\n You can also track your shipment directly: [Track shipment](/transfer-appliance/docs/4.0/order-appliance#track)\n\n After you receive the appliance, [confirm the Appliance Receipt](/transfer-appliance/docs/4.0/receive-appliance#confirm_receipt). Then, [verify the package\n contents](/transfer-appliance/docs/4.0/receive-appliance) to ensure that you\n have everything required to use the appliance.\n | **Important:** If you've received this email and didn't receive your appliance, contact Transfer Appliance Team for help.\n2. Before connecting the appliance to your network, [validate that it hasn't\n been tampered with during\n shipping](/transfer-appliance/docs/4.0/receive-appliance#validate) and\n submit the Transfer Appliance Attestation Passcode returned by the appliance in the appliance detail\n page of the Google Cloud console.\n\n If the device was not tampered with during shipping, the credentials will be\n displayed in the Google Cloud console. Otherwise, the Google Cloud console will show\n an error message. If you encounter this error, contact the\n Transfer Appliance Team at [data-support@google.com](mailto:data-support@google.com)\n for assistance.\n3. After receiving login credentials from Google Cloud console, do the\n following:\n\n 1. [Configure IP network ports](/transfer-appliance/docs/4.0/ip-network-ports).\n 2. [Connect the appliance](/transfer-appliance/docs/4.0/receive-appliance#connecting) to your network.\n 3. [Configure the appliance software](/transfer-appliance/docs/4.0/receive-appliance#configure-appliance).\n\nCopying data to the appliance\n-----------------------------\n\nTo capture your data, follow these steps:\n\n1. Use copy tools of your choice to\n [copy data to the appliance](/transfer-appliance/docs/4.0/transfer-data).\n\n - If you selected an online-capable appliance and enabled online copy on\n the appliance: The appliance streams the data you copy to the appliance\n to your Cloud Storage bucket. Files and empty directories are\n deleted from the appliance after they're successfully copied to your\n Cloud Storage bucket.\n\n - If you selected an offline-only device or disabled online copy on the\n appliance: After you complete all copying to the appliance,\n [finalize the copied data](/transfer-appliance/docs/4.0/return-appliance#finalizing)\n to prepare for shipping.\n\n - All files copied to the appliance must comply with Cloud Storage\n [file size limits](/storage/quotas#objects) and\n [naming guidelines](/storage/docs/naming-objects).\n\n2. Verify that you copied all data to the appliance before finalizing.\n\n3. [Finalize copied data](/transfer-appliance/docs/4.0/return-appliance#finalizing).\n\n4. Enter the passcode returned by the `ta finalize` command in the form\n included in the email titled *Google Transfer Appliance\n Return Instructions* sent by the Transfer Appliance Team.\n\n To view the passcode again, run `ta status`.\n\n The Transfer Appliance Team responds with the shipping label for the\n Transfer Appliance for the given passcode.\n | **Note:** The passcode is specific to each appliance. If you have several Transfer Appliances, verify that the session ID printed on the shipping case matches the session ID of the passcode you are using.\n5. Once you receive the shipping label, turn off the appliance and disconnect\n all cables to it.\n\n6. Once you have the shipping label,\n [package and return the appliance](/transfer-appliance/docs/4.0/return-appliance).\n\nComplete your copy\n------------------\n\nAfter returning the appliance, do the following to complete your transfer:\n\n1. Verify that we received your appliance.\n\n Transfer Appliance Team emails you when we receive your appliance at our data\n transfer center. We'll start transferring data from the appliance to the\n destination Cloud Storage bucket indicated in\n [the appliance order form](/transfer-appliance/docs/4.0/order-appliance#order).\n2. Verify that we completed your transfer.\n\n Transfer Appliance Team emails you when we've completed transferring data from\n the appliance to your Cloud Storage bucket.\n3. [Validate your data](/transfer-appliance/docs/4.0/access-data) in the\n destination Cloud Storage bucket to verify that your data\n transferred as you expected. We recommend that you don't delete\n your source data until you verify that it successfully transferred to your\n Cloud Storage bucket.\n\n - Data that's been transferred from your appliance is displayed in your\n Cloud Storage bucket.\n\n - The following additional directories are created:\n\n - A `storage-transfer` directory that contains your Storage Transfer Service logs.\n - A `transferappliance` directory that logs successful and failed transfers from the appliance.\n - Sometimes, a `cloud-ingest` directory that is used to coordinate the data uploaded from the appliance to your destination Transfer Appliance bucket.\n\n You can delete these directories once your data transfer is complete and\n the data is fully available in your Transfer Appliance bucket.\n4. Optional: You may request a Transfer Appliance wipe certificate to\n verify that we've securely wiped all data after copying it to\n Cloud Storage. If you're interested in a wipe certificate, contact\n Transfer Appliance Team."]]