Guides on AuthOS Docs | Auth Operating System API and SDK Guides

Evaluate AuthOS

Mon, 01 Jan 0001 00:00:00 +0000

Use this guide to evaluate AuthOS without mixing the evaluation with framework integration. The result is a working instance you can inspect and a recorded decision about what to try next.

Prerequisites

A Linux host you can use for a short-lived standalone evaluation
Shell access and permission to install and run services
About 20–30 minutes
Acceptance that AuthOS is Beta and its SDKs are pre-1.0; pin exact versions and perform your own security and interoperability review

Run the evaluation

Follow Install standalone AuthOS. Stop if its health and readiness checks do not pass.
Follow Set up the platform using the one-time bootstrap link printed by the installer.
Confirm that the lite workspace opens and that you can inspect the demo organization and demo application.
Review Architecture and the project status against your requirements.
Choose one separate integration or deployment path. Do not add framework packages merely to prove that the AuthOS process is healthy.

Completion check

/health and /health/ready both succeed.
You can sign in to the lite workspace as the bootstrapped platform owner.
The demo organization and application are visible.
You have recorded a proceed, investigate, or stop decision and its reason.

Next steps

Integrate a Frontend

Mon, 01 Jan 0001 00:00:00 +0000

This guide connects a browser application to AuthOS. It assumes installation and platform setup are already complete and deliberately does not repeat those operator procedures.

Prerequisites

A reachable AuthOS base URL supplied by the platform operator
Node.js 18 or newer and npm
A registered organization and service for this application
Allowed browser origins and callback URLs that match the development or production application URL

Choose one client

Application	Integration entry	Use it when
React or Next.js client components	`@drmhse/authos-react`	You want React providers and sign-in components.
Vue 3 or Nuxt	`@drmhse/authos-vue`	You want Vue application integration.
Framework-agnostic browser code	`@drmhse/sso-sdk`	You want direct typed SDK calls and session handling.

Choose exactly one primary client for the first integration. Pin its exact pre-1.0 version rather than depending on an unconstrained upgrade.

Integrate a Backend

Mon, 01 Jan 0001 00:00:00 +0000

This guide connects server-side application code to AuthOS. It assumes an operator has already installed and configured the platform.

Prerequisites

A reachable AuthOS base URL stored as server-side configuration
Node.js 18 or newer and npm for the Node.js path
A registered organization and service
A clear choice between verifying interactive-user access tokens and acting as a non-interactive service

Choose the backend boundary

Use @drmhse/authos-node when a Node.js server needs token verification or Express middleware. Use the Service API SDK module and Service API HTTP reference for workloads that act without an interactive browser session.