Link Search Menu Expand Document
Start for Free

Getting Started with Stardog Cloud

Get jump-started with your private Stardog Cloud Instance

Page Contents
  1. Logging in For the First Time
    1. Signing in with Google Authentication
    2. Signing in with username and password
  2. Configuring your first users
  3. Accessing API Endpoint
    1. CLI tools macOS Homebrew
    2. CLI tools Debian Based Systems
    3. CLI tools RPM Based systems
    4. CLI tools Amazon Linux
    5. CLI tools for Windows
  4. Getting Stardog Cloud Service Status Information
  5. Getting Started Resources
  6. Blogs
  7. Tutorials
  8. Video Trainings
  9. Getting Support
  10. Community
  11. Stardog Labs

Stardog Cloud provides you with a dedicated Stardog Instance with a custom URL endpoint of your choosing. You get administrative access to manage your Instance. Your custom url will appear in the form https://[custom-name].stardog.cloud. Visit your endpoint to get started.

Logging in For the First Time

After receiving your invitation email with your private Stardog Cloud endpoint you will be able to log in for the first time to begin configuring and using your Stardog Knowledge Graph. If the email address you provided when signing up for the service supports Google Authentication then you can sign in directly using the ‘Sign in with Google’ button (more identity providers will be coming soon). Otherwise, you will be provided with a temporary password which will expire within 24 hours of receiving the invitation message. If you use the password method for your first time log in you will be required to change your password before it expires.

Signing in with Google Authentication

Google sign in

Click ‘Sign in with Google’ if your email account Supports Google OAuth

Signing in with username and password

Password sign in

Click ‘connect’ if you are signing in with a username and password.

Configuring your first users

After logging in for the first time you will be presented with the Stardog Studio Web Interface which will give you access to administer Stardog in addition to many other development and visualization features. Your initial user will have administrative access to manage Stardog including:

  • create new users and roles
  • delete the users and roles that you have created
  • create new databases
  • write to existing databases
  • delete databases
  • manage virtual graphs
  • and more

Stardog uses role based access control (RBAC) similar to many traditional databases. To grant additional team members access we recommend that you provision additional users with access that is limited appropriately. For example, you could provision a new user that has the role reader (a role automatically configured by stardog cloud) for a new user you wish to be able to view data but not alter it.

Create User

Creating a new user

We recommend that for any programmatic access to Stardog Cloud you create dedicated service account users and then limit the service account access to the minimum required by the application.

We recommend reviewing the Stardog permissions model to fully understand what is possible.

Much of Stardog security documentation refers to configuring Stardog Server Authentication securely for on-premises deployments. With Stardog Cloud your endpoint is configured by default to follow security best practices.


Accessing API Endpoint

In addition to the Stardog Studio Web Interface you can access your Stardog REST API endpoint directly at:

https://[custom-name].stardog.cloud:5820

Access to the API endpoint is done via http basic authentication over SSL. The API endpoint can be accessed via the administrative CLI tool stardog-admin and data access CLI tool stardog. For complete reference documentation on these tools refer to the Stardog Admin CLI Reference and Stardog CLI Reference. Once you have the CLI installed you can use it to manage your endpoint. For example to list databases:

​​$ stardog-admin --server https://[custom-name].stardog.cloud:5820  db list

CLI tools macOS Homebrew

To install Stardog via Homebrew, use the following command:

​​$ brew install stardog-union/tap/stardog

Homebrew will take care of the installation for you including adding Stardog’s /bin folder to your PATH so stardog and stardog-admin commands can be used regardless of current working directory.

CLI tools Debian Based Systems

To install Stardog CLI using apt-get run the following commands:

$ curl http://packages.stardog.com/stardog.gpg.pub | apt-key add
$ echo "deb http://packages.stardog.com/deb/ stable main" >> /etc/apt/sources.list
$ apt-get update
$ apt-get install -y stardog[=<version>]

This will first add the Stardog gpg key to the systems and then fetch and install the latest Stardog deb package.

Stardog binaries should now be in the /opt/stardog directory.

CLI tools RPM Based systems

To install Stardog using yum run the following commands:

$ curl http://packages.stardog.com/rpms/stardog.repo > /etc/yum.repos.d/stardog.repo
$ yum install -y stardog[-<version>]

Stardog binaries should now be in the /opt/stardog directory.

CLI tools Amazon Linux

Certain Amazon EC2 instances do not let you redirect output into /etc/yum.repos.d as specified above. On such instances you can install Stardog like so:

$ sudo yum-config-manager --add-repo http://packages.stardog.com/rpms/stardog.repo
$ sudo yum-config-manager --enable stardog
$ yum install -y stardog[-<version>]

CLI tools for Windows

  1. Download the distribution.

  2. Unzip the file and open a command prompt. Tools are located in bin/ directory

Getting Stardog Cloud Service Status Information

We provide a Stardog Cloud Service Dashboard at https://status.stardog.com. This dashboard displays information about the current service incidents and uptime history.

Stardog Cloud Status


Getting Started Resources

Blogs

We’ve highlighted some of our foundational blogs below. Additional blog posts are available on our blogs page. While these blog posts are more high level in nature, Stardog Labs contains our engineering blog.


Tutorials

We’ve highlighted some of our foundational tutorials below. Additional tutorials are available on our tutorials page.

Getting Started Series

Video Trainings

We’ve highlighted some of the foundational trainings below. Additional trainings are available on our trainings page.

  • Getting Started With SPARQL

    Learn about:

    • The basics of the RDF graph model
    • How to build a simple SPARQL query, step-by-step
    • Stardog’s SPARQL extension to find shortest paths
    • More advanced SPARQL features like optional values, negation and aggregation
  • Reasoning with RDF Graphs and Ontologies

    Learn about:

    • What reasoning means and how it relates to data modeling
    • The basics of reasoning with RDFS and OWL ontologies
    • How to use user-defined rules for inferring new types and edges in RDF graphs
    • Using reasoning with SPARQL queries inside Stardog Studio
    • How logical reasoning relates to statistical reasoning and machine learning
  • Data Validation & SHACL

    Learn about:

    • The basics of RDF data validation
    • The core features of the SHACL language
    • How SHACL validation interacts with RDFS/ OWL reasoning
    • Stardog’s integrity constraint validation capability for validating SHACL constraints

Getting Support

Please use the appropriate channel to request support – customers should file a support ticket or work directly with their Customer Success Manager.


Community

Need some help? Want to be part of the Stardog Community? Our Community page is a great resource to discuss Stardog and Stardog Studio, make support requests, ask questions, etc.


Stardog Labs

Recently launched in the Summer of 2020, Stardog Labs is a new hub of insight, news, and buzz about knowledge graph technology. The site features technical blogs, showcasing job opportunities focused on knowledge graph development, and curating research papers and open source projects.

While Stardog Labs will serve as our Engineering blog, it’s also designed for participation from our community of Stardog users, academic researchers, and knowledge graph enthusiasts.