odrive

The odrive Developer Hub

Welcome to the odrive developer hub. You'll find comprehensive guides and documentation to help you start working with odrive as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Set Up Your odrive

INSTALL DESKTOP SYNC

Install desktop sync to directly access odrive files on your computer. The application will create an odrive folder that stays automatically synchronized with your odrive account. 

odrive is a folder found in your /user rootodrive is a folder found in your /user root

Download and run installer:

Full Desktop Sync Client:
odrive Sync - Mac 
odrive Sync - Windows 

Command Line Agent:
odrive Sync Agent - Linux, Windows, and Mac 

Desktop sync requires Windows 7+ or Mac OS 10.10+

USING WINDOWS SYNC

Click here for a quick video on the basics of using odrive on Windows

You can browse and open odrive files like you do normal files and folders through Windows Explorer. When you want to manage your account, you open the odrive tray menu. When you want to kick off an action on a file or folder, you right-click on the file or folder. 

You can right click on any file or folder to see your odrive options. 

Right-click on any folder, in or out of odrive,<br> to reveal odrive options that can be performed on that folderRight-click on any folder, in or out of odrive,<br> to reveal odrive options that can be performed on that folder

The right-click menu dynamically changes depending on whether it’s a file or folder; and whether it’s a placeholder or the actual file/folder. 

The odrive menu is located in your system tray. 

odrive Windows tray is located in the bottom right task barodrive Windows tray is located in the bottom right task bar

The tray menu will also enable you to manage global settings and sync control, as well as open odrive on the Desktop or on the Web.

USING MACOS SYNC

Click here for a quick video on the basics of using odrive on MacOS

You can browse and open odrive files like you do normal files and folders through Finder. When you want to manage your account, you open the odrive tray menu. When you want to kick off an action on a file or folder, you right-click on the file or folder. 

You can right click on any file or folder to see your odrive options. 

Right-click any folder in your finder to reveal odrive optionsRight-click any folder in your finder to reveal odrive options

The right-click menu dynamically changes depending on whether it’s a file or folder; and whether it’s a placeholder or the actual file/folder. 

The odrive menu is located in your system tray. 

The odrive Mac system tray is in the upper right cornerThe odrive Mac system tray is in the upper right corner

The tray menu will also enable you to manage global settings and sync control, as well as open odrive on the Desktop or on the Web.

LINK YOUR STORAGE

After you link all your clouds, apps and storage to odrive, they will appear as individual folders in your file system. You will not have to enter account credentials again to access that storage with odrive. 

From your system tray menu, click on "Manage Storage". 

Manage storage is located in your odrive system trayManage storage is located in your odrive system tray 

It will take you to your "My odrive" webpage, where you see the storage and links you have previously authenticated. To link more, click on the "+": 

Add more links by finding '+ Link Storage'Add more links by finding '+ Link Storage' 

Select what you want to link and authorize the new storage. You will then see that newly added storage in "My odrive" and in your odrive desktop. It can take a few seconds to show-up on its own, buy you can perform a right-click->refresh to show it immediately.

## 

UNLINK YOUR STORAGE

There may be cases where you need to unlink storage from your odrive account. You can also do this from the odrive webclient.

On the main "My odrive" page, where your storage links are listed, click on the 'V' icon to the right of the storage you wish to unlink and select "UNLINK".

When you unlink your storage account, the corresponding folder on the desktop client will be moved to the OS trash/recycle bin once odrive sees the change. You can trigger an immediate action for this by right-clicking the odrive root folder and selecting "Refresh".

Unlinking storage from odrive will not affect the cloud storage. All of your data in the applicable storage will remain as it is and available.

You can always link the storage again at a later time, using the instructions above.

📘

Relinking storage to revert back to placeholder cloud files

If you don't need the fine-level granular control of using right-click to Unsync individual files and folders, you can always unlink the storage and then relink it. When you relink storage, everything resets to the initial state of having a top-level placeholder cloud file, taking up zero disk space.

Granular control with Unsync is a Premium feature, but anyone with a free plan can always unlink and relink their storage to start over again with all placeholder files.

LINK MULTIPLE ACCOUNTS FROM THE SAME SERVICE

odrive makes it easy to link multiple accounts from the same service (e.g. multiple Dropbox or Google accounts) so that they are always available from one place. You no longer need to log out of one account to access another account.

We have a short video that walks through linking all of your Google Drive accounts, or you can follow along below.

When trying to link a 2nd, 3rd, etc.. account for a service, you will need to make sure you are logged out of any accounts you already have linked, first.

  1. Go to the service's own web client and make sure you are completely logged out.
    Dropbox: https://www.dropbox.com/logout
    Amazon Drive: https://www.amazon.com/clouddrive/signout
    Google: https://accounts.google.com/Logout
    Box: https://app.box.com/logout
    OneDrive: https://login.live.com/logout.srf
    Office365: https://login.microsoftonline.com/common/oauth2/logout

  2. Go to https://www.odrive.com and link your desired account.
    https://www.odrive.com/account/myodrive#pickLinkScreen 

View of multiple Google Drives linkedView of multiple Google Drives linked

Keep selecting the same service link for every account of that service you have. You will then see every newly added storage in "My odrive". 

View of multiple Google Drives linkedView of multiple Google Drives linked 

You can then rename your links to avoid mixing them up on your desktop. 

Rename your links to differentiate themRename your links to differentiate them 

We do not limit how many storage accounts you link, even if they are from the same service. 

MOVE ODRIVE FOLDER TO ANOTHER VOLUME

Upon installation, odrive is mapped to a default drive location, e.g. C:/ drive (Win) or /user/ (Mac), but you may want to move it to another location (e.g. D:/ drive or secondary internal drive) to target a larger storage. 

From the odrive tray menu, select "Move odrive folder". Then browse to the new location you want. 

Select Move odrive from your traySelect Move odrive from your tray 

A new, unsynced odrive folder will be created and will be your active odrive folder moving forward. An old odrive folder will remain where it is in your root (this can serve to be a useful backup). 

🚧

Important Note:

Moving the odrive folder to an external volume (external drive, sd card, network mount) is an unsupported configuration. This type of setup can lead to unanticipated behavior or poor performance.

ACCESS ODRIVE FROM THE WEB

Although you can access odrive from the web, it is missing the main benefits of sync that you get from the desktop. If you are actively working with files, we recommend that you use the desktop sync app, but using the web for access when you are remote is a useful alternative in a pinch. 

From your desktop, you can open the odrive web client via the odrive tray menu by selecting "Manage links". 

Select manage storageSelect manage storage 

You are taken to your account main page. We refer to it as your "My odrive" page. It gives you a full view of all your odrive links and gives you access to your files. 

View of multiple Google Drives linkedView of multiple Google Drives linked 

You can browse and view all your files in a thumbnail list or a full gallery view. 

Browse and view all your files onlineBrowse and view all your files online 

You can download and upload files. 

Download your files from onlineDownload your files from online 

You can share a link to any file or folder. 

Share files and folders from onlineShare files and folders from online

DEAUTHORIZE THE DESKTOP CLIENT

There may be times where you need to deauthorize the desktop client to login with different user, or to perform a reset of the local odrive folder and client cache in order to start fresh.

To perform a desktop client deauthorization, go to the odrive tray menu -> Authorized user -> Deauthorize.

This will create a backup of the current odrive folder and reset and reinitialize the cache. Once you login again you will have a fresh odrive folder with only placeholder files.

The backup folder that is created will be named "odrivebackup-[current date here]".

This procedure will not affect any of your cloud storage. It only affects the local desktop.

Updated 2 months ago

Set Up Your odrive


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.