Stratus5

​Product Workspace Setup

​Choosing Blueprints

Blueprints are the foundation for deploying applications (Sites) in Stratus5. Before you can launch Sites, you need to ensure the necessary Blueprints are available or created within your workspace.

  • Review Available Blueprints: Navigate to the "Blueprints" section in the Admin Console to see the Blueprints currently available in your workspace.
  • Identify Needs: Determine which application stacks or pre-configured services you need (e.g., WordPress, Node.js, specific databases).
  • Create or Select:
    • If the required Blueprints exist, you are ready to deploy Sites from them.
    • If not, you may need to create new Blueprints from public or private Docker images.
  • Further Information: For detailed instructions on viewing, creating, and managing Blueprints, please refer to the Managing Blueprints documentation.

Selecting the right Blueprints upfront streamlines the process of launching consistent and properly configured application instances (Sites).

​Setting Up API Access (Admin Users)

To interact with the Stratus5 API programmatically (e.g., for automation or integration), you need to create dedicated admin users. The credentials (email and password) of these users are used for Basic Authentication against the API endpoints.

​Using the Admin Console (UI)

  1. Navigate: Go to "Settings" -> "General" -> "Admin Users" in the main navigation menu.
  2. Create User: Click the "New User" or "Add Admin User" button on the Admin Users list page.
  3. Enter Details: Provide the required information on the "Add Admin User" form:
    • Full Name: The user's full name.
    • Email: The user's email address, which will serve as their username for login and API access.
    • Temporary Password: Set an initial password for the user. It must be at least 8 characters long and include 1 number and 1 capital letter.
  4. Confirm: Click "Save" to create the new user.

The Email and Password combination for each created Admin User can then be used to authenticate API requests using HTTP Basic Authentication.

From the Admin Users list, you can also:

  • View user details (Full Name, Email, Creation Date).
  • Edit user details (like Full Name).
  • Change Password for a user.
  • Delete users (if permissions allow).

Remember to manage these credentials securely.

Once your Stratus5 workspace is provisioned, there are a few key steps to configure it effectively for deploying and managing your applications. This guide covers adding custom domains, selecting necessary Blueprints, and setting up users for API access.

​Adding and Managing Custom Domains via DNS Zones

To use your own custom domain (e.g., my-saas.app) for hosting your applications and managing its DNS records directly within Stratus5, you need to add it as a DNS Zone.

​Delegating Your Domain to Stratus5 Nameservers

  1. Navigate: Go to the "Zones" section in the main navigation menu of the Admin Console.
  2. Create Zone: Click the "New Zone" or "Create Zone" button.
  3. Enter Domain: Input your custom domain name (e.g., my-saas.app) in the required field and confirm.
  4. Update Nameservers: Crucially, after creating the zone in Stratus5, you must log in to your domain registrar (where you purchased your domain) and update its nameserver (NS) records to point to the Stratus5 nameservers:
    • pdns1.stratus5.com
    • pdns2.stratus5.com
    • pdns3.stratus5.com This step delegates the DNS management authority for your domain to Stratus5. Propagation of these nameserver changes can take anywhere from a few minutes to 48 hours.

Once your domain's nameservers have successfully propagated and point to Stratus5 the domain is active. From this point onwards you can launch applications using this domain and they will resolve correctly.

After completing these steps – configuring your domain, selecting Blueprints, and setting up API users – your workspace is well-prepared for deploying and managing applications effectively through both the UI and the API.

Next page →
Applications