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. Signing Up for Stardog Cloud
  2. Subscribing to Stardog Cloud
  3. Logging in For the First Time
  4. Configuring your first users
  5. Supported Data Sources
  6. 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
  7. Getting Stardog Cloud Service Status Information
  8. Getting Started Resources
  9. Blogs
  10. Tutorials
  11. Video Trainings
  12. Getting Support
  13. Community Forum
  14. Stardog Labs

Stardog Cloud is our complete Enterprise Knowledge Graph Platform provided as a service. As a part of your subscription, you get a dedicated Stardog instance (hosted by Stardog) and your account will have administrative access to your new environment. You also get easy access to the Stardog Applications: Explorer, Designer, and Studio. For more information on Stardog Cloud please visit our website.

Signing Up for Stardog Cloud

Before getting a Stardog Cloud environment, you need to create your Stardog Cloud Account. Simply go to the Stardog Cloud Portal here to get started. Creating an account is free and takes only a minute.

Subscribing to Stardog Cloud

Once you have created a Stardog Cloud Account and have verified your email, you can create a connection to a Stardog instance. Select the “Add a new Connection” option from the Stardog Connections menu in the main navigation bar, or head to our getting started page.

On the getting started page, you can purchase an Essentials Stardog instance, or you can start your trial with a Free Stardog instance. Only one Free instance can be allocated per Stardog Cloud Account.

Logging in For the First Time

Once you have confirmed your subscription, the environment will be provisioned for you and associated with your account. As soon as the new instance is available for use, your Stardog Cloud Account will be updated and your new instance will be available in your list of connections on the Stardog Cloud Portal.

Configuring your first users

Log into your Stardog Cloud Account and click the connection to the Stardog instance you wish to manage. From there, launch Stardog Studio, our Knowledge Graph IDE. With Studio you can administer your Stardog instance and create users. Your initial user will have administrative access to manage Stardog including:

  • creating new users and roles
  • deleting the users and roles that you have created
  • creating new databases
  • writing to existing databases
  • deleting databases
  • managing 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

Note that a Stardog Server user in your instance is not related to the Stardog Cloud Account used to log in to the Stardog Cloud Portal. The former authenticates a user with the instance itself, while the latter allows access to the Stardog Cloud Portal, where you can configure connections to multiple Stardog Server instances.

After creating a Stardog Server user with Studio, you can provide the username, password, and URL for the instance to a person who has created a Stardog Cloud Account; that person can then create a connection to the Stardog Server instance using the username, password, and URL that you provided.

We recommend that for any programmatic access to your Stardog instance you create a dedicated service account user 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 the 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.

Supported Data Sources

Each Stardog instance running in Stardog Cloud is pre-configured with the client libraries needed to access the following data sources.

Database Driver License
AWS Athena AthenaJDBC42_2.0.7.jar (*) Apache 2.0
Databricks SQL databricks-jdbc-2.6.25.jar Custom
MongoDB mongo-java-driver-3.8.2.jar Apache 2.0
MySQL & MariaDB mysql-connector-java-8.0.25.jar GPLv2
PostgreSQL postgresql-42.2.5.jar BSD 2 Clause
Snowflake snowflake-jdbc-3.13.25.jar (*) Apache 2.0
Spark SQL SparkJDBC42.jar Custom

Drivers marked with an asterisk (*) are included with each Stardog instance, and they are known to work with Stardog, but they are currently being Beta-tested in Stardog Cloud.

You can read more about using a data source with a Virtual Graph in Stardog here.

Accessing API Endpoint

In addition to using the Stardog Applications, you can access your Stardog instance via its 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 Stardog instance. 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 that the stardog and stardog-admin commands can be used regardless of the 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 training videos below. Additional trainings are available on our trainings page.

  • Getting Started with RDF & 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

    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 Quality

    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. Enterprise customers should file a support ticket or work directly with their Customer Success Manager. Free and Essentials customers can get support in our Stardog Community Forum.

Community Forum

Need some help? Want to be part of the Stardog Community? Our Community Forum is a great resource to discuss Stardog, Stardog Cloud, and the Stardog Applications (Designer, Explorer, and Studio), make support requests, ask questions, etc.

Stardog Labs

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.