Storj IconSTORJ | DCS Docs
Linksharing Service

Linksharing Service #

Overview #

The Linksharing service provides an easy way to share an object via a web browser. Linkshare links may be shared with the following features:

  • Storj DCS Linkshare web page - displays a preview of the shared object, including a streaming player for multimedia files along with a map displaying the geolocation of the storage nodes storing the encrypted and erasure coded pieces of the object
  • Path-based linkshare - displays a list of objects with a shared path in a browser. This feature allows sharing a folder of objects. When clicked in a browser, any of the objects will be displayed individually on a Linkshare web page
  • Direct download Linkshare - a URL to directly access and download an object via the internet without loading a web page
  • Restricted Access - Linkshare links are read-only by default, but may be further restricted with any supported access restriction (bucket, path and prefix, time window)
  • Revokable Access - Link share links may be revoked by deleting the associated Access Grant from the Auth Service or by revoking the Access Grant via the revocation service.

The Linkshare service is part of the Storj Edge Services and provides an additional way to access objects over the internet via a browser in addition to the S3-compatible gateway.

Note: All of the Edge Services, including the Linksharing service use server-side encryption.

Linkshare Examples #

The Storj Linkshare web page and Path-based Linkshare web page are shown below:

Storj Linkshare web page example

Storj Path-based Linkshare web page example

Linkshare QuickStart #

To accelerate your time to success we offer an Object Browser GUI that allows you to upload and share with no command line interface required. Check out the tutorial for the Object Browser.

The steps for sharing an object via the GUI are included in that tutorial.

Linkshare via CLI (Advanced) #

If you prefer a command line interface (CLI) or wish to programmatically integrate to Storj DCS we have our CLI documentation in addition to our Client Libraries. You can also host full static websites via the Linksharing service.

Regions of availability #

Linksharing Service is available in several geographical regions. When you use the endpoint, it automatically routes traffic from the closest region to your location.