Quick Start
Get up and running with Onedata in minutes — from logging in to accessing and managing your research data.
Core concepts
Three building blocks you need to understand before you start.
Spaces
Distributed virtual volumes for organizing data and interacting with logical files, physically stored across one or more providers.
Providers
Entities that support user spaces with physical storage resources by operating Oneprovider services.
Zones
Onedata ecosystems: federations of providers that enable collaboration between their users, each operated via a Onezone service.
Step-by-step guide
Choose your path and follow the steps to get Onedata running your way.
Choose your quick start path
Select one of the options above to see the step-by-step guide.
Open the demo environment
Go to demo.onedata.org — a publicly accessible zone, which you can use to familiarize yourself with the system if your don't have access to any Onedata services. You will need an account in Google or EGI for that purpose. If you don't have one, contact us and we will create a test account for you.
Note: There are many zones existing around the world. Check whether your institution is part of the Onedata ecosystem or if you have access to EGI services — then you may cover the guide using the PLAYGROUND space in EGI DataHub.
Log in
Click on the selected identity provider and follow the steps to log in to Onedata. You will have to accept sharing your user information, so that you can be authenticated by the Onezone service.
Note: The “green key” icon is reserved for the login of administrators and special users created through the Onepanel administrative interface. Regular users should use social or institutional accounts to sign in.
Explore the Sandbox Space
All users logging in to demo.onedata.org are granted access to the Sandbox. It's a perfect place to play around with Onedata and test its features.
Note: Cannot see the Sandbox space? Check our docs for troubleshooting.
Warning: The Sandbox space is intended to be a testing environment and comes with no guarantees. It is cleaned if it becomes cluttered.
Do not store any private or sensitive data in the space, as it's available to all the logged-in users.
Create your own private directory
Navigate to the DATA → Sandbox → Files tab and create a new directory using the action in the top right corner or by invoking the right-click menu.
Right-click on the newly created directory and choose Permissions from the context menu. Switch to the ACL permission type and add a single entry, for yourself, allowing all operations.
Hit Save and done — you now have your own directory in the Sandbox Space, to which no one else has access (ACLs implicitly deny access if there is no explicitly allowing entry). You may use this directory to upload some data and test Onedata features. If you wish for others to see the fruits of your experiments, feel free to place your data in a non-ACL-secured location.
Note: Instructions unclear and you are stuck? See the more detailed visual guide.
Mount with Oneclient (optional)
For POSIX access to your files, follow the Oneclient guide.
Run Docker images in demo mode
Use the Docker images in demo mode to start Onedata services and components with a minimal, but fully functional config, providing a “hello world” deployment. You just need a Linux-based system with Docker engine installed.
Follow the steps described in the demo mode documentation.
Deploy Onezone
Deploy Onezone with the script utilizing our official Docker images to run Onezone on any Linux OS supporting Docker. This method involves Docker Compose under the hood.
Follow the steps described in the Onezone installation guide.
Deploy Oneprovider
Deploy Oneprovider with Onedatify — an easy-to-use wizard that sets up a Docker-based Oneprovider instance. The script automatically registers the deployed Oneprovider instance to a selected Onezone service and allows for interactive configuration of a storage backend and space support.
Follow the steps described in the Onedatify CLI wizard guide.
Ready for a full deployment?
Tested Onedata and ready to set it up for your institution or research group? Get in touch — we'll help you build a fully-fledged ecosystem for your use cases.
Request a Demo