You are here: Home User Information Facility Services Cloud Storage Using BNLBox Cloud Storage

Using BNLBox Cloud Storage

by Hironori Ito last modified Dec 20, 2019 04:30 PM
Please follow these instructions to use SDCC cloud storage.


BNLBox is a cloud storage service for BNL users to store their scientific data and documents.  The service should be accessible available anywhere with the internet access, allowing users to access their data from around the world.   The files stored in the BNLBox can be easily shared with other users of BNLBox as well as the external collaborators.

  1. Account:
    1. Any person with the account in  BNL SDCC or BNL ITD Active Directory will be able to use BNLBox.
      1. To obtain BNL SDCC account, please follow these instructions on the SDCC page.
      2. To obtain BNL ITD Active Directory Account, please follow ITD's instruction.
    2. To initialize your storage account:
      1. Go to
        bnlbox main
      2. Click "Log in with BNL Login".  This should redirect to the the page shown below.
        BNL LoginUsing BNLBox Cloud Storage
      3. In this login page, you must choose either to use (1) SDCC account or (2) BNL ITD's Active Directory account .  NOTE:  Once you chose the account option, you can not go back and forth.
        1. SDCC account:  Fill your username/password in the left
        2. BNL ITD's Active Directory account:   Click the icon on the right.
      4. This will initialize your account, which is given 50 GB of space by default. More space can be requested if needed via a help ticket.
  2. How to use it.
    1. Use your browser. The browser is the easiest method to access your cloud storage.
      1. Login at
      2. Once you login, you will see the basic directories.
        1. Your login initial should be indicated at the top right corner.
        2. The image of blue color folders folder indicates directories or folders in the system. To go the directory, just left click on the name of the directory.
        3. To upload your file, just left click upload sign at the top of the page. This will bring up the upload_file_2 options.  Left click of "Upload" option will allows you to chose your file(s) for uploading to the BNLBox service.
        4. To create a new directory/folder, just left click upload sign at the top of the page like the uploading a file.  Then, the left click on  the "Folder" option will allow a user to create a new folder with a desired name.
        5. To download files, left click the corresponding preview icons to show the download check sign sign.  This will bring up the "Download" download signoption at the top of the page. Just left click to start the download of those files.  download selection
        6. To delete files, left click the corresponding preview icons to show the download check sign sign.  This will bring up the "Delete" delete optionoption .  Just left click this icon to delete the selected files.delete selection
        7. To share data, left click on the share icon share icon. This will bring up the sharing option on the right side of the page. share option main
          1. To share with the user of BNLBox. Type the name of the desired user name in the box.  Once the search has finished, select the user.
          2. To share with external users without BNLBox account, you have a few options.
            1. "URL"  with password.   By selecting "Share link", you can generate the username with password of your choice.   Then, you can inform the external users with this URL to any other users with the corresponding password.
            2. "Email".  By typing the email address of the external user, the BNLBox will send the external users the email with URL.
            3. "Guest Account".    By typing the guest account name, it will generate the guest account and send the email to external user about the invitation for the guest account.
    2. Clients; There are various clients available to use for your access to the cloud storage service at BNL
      1. Desktop/Laptop  You can download it from the following link
        1. Windows
          1. By default, it will create the "nextcloud" directory in C:\Users\YOURUSERNAME\nextcloud directory. (One can choose different directory)  The content of this directory will be synchronized with the cloud storage.
        2. Mac
        3. Linux
      2. Mobile devices.  You can find the instruction at the following link
        1. Android
        2. IOS
    3. Others : NOTE: Please use default app if it satisfies your need.
      • If you have very large amount of data or if you want to use the storage like un-cloud storage like good-old copy command, there is a custom command to upload/download data.  It is located at  You need "ruby" language, "ruby " is available in mac/linux/windows if not installed already (
      • ruby copy_bnl_box.rb -h
        Usage: copy_bnl_box.rb [options] source destination
        NOTE: to specify the owncloud storage, you need to append 'box:' to your path seen in your bnl box service
        -h, --help                       Display help message
        -s, --https_proxy ProxyHost      Set https proxy
        -r, --url URL                    Set none-default url
        -p, --password password          Set User Password
        -u, --username username          Set User Name
        • Examples
          1. Copy a local file to BNLBox
            • ruby copy_bnl_box.rb /A/B/C/ box:/Data/
          2. Copy a local directory and its contents to BNLBox
            • ruby copy_bnl_box.rb /A/B/C/MyDirectory box:/Data/MyDirectory
          3. Copy a remote file in BNLBox to a local location.
            • ruby copy_bnl_box.rb box:/Data/ /A/B/C/
          4. Copy a remote directory and its contents to a local location.
            • ruby copy_bnl_box.rb box:/Data/MyDirectory /A/B/C/MyDirectory
    Document Actions