Skip to main content

Documentation Index

Fetch the complete documentation index at: https://noradocs.solomontsao.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide takes you from a fresh machine to a running, validated agent runtime. You will install Nora using the one-line installer or Docker Compose, create your operator account, connect an LLM provider, deploy your first agent, and confirm the end-to-end workflow is healthy — all in about 15 minutes.
The installer can install Docker, Docker Compose, and Git for you if they are not already present on your machine. You need macOS 12+, Linux (Ubuntu 20.04+, Debian 11+, or Fedora 38+), or Windows 10+ with WSL2, plus admin or sudo access.
1

Install Nora

Run the one-line installer for your platform, or bring up the stack manually with Docker Compose if you prefer full control over the setup.
curl -fsSL https://storage.solomontsao.com/setup.sh | bash
The installer clones the repository, verifies Docker and Docker Compose, generates platform secrets, walks you through access mode and platform mode choices, creates the initial admin account, optionally collects an LLM provider key, and then starts the full Nora stack.If you prefer to configure things manually, clone the repo and bring up the stack yourself:
git clone https://github.com/solomon2773/nora.git
cd nora
cp .env.example .env
# Edit .env with your secrets, then:
docker compose up -d
When the installer or Docker Compose finishes, it prints the base URL it configured. Local mode uses http://localhost:8080 by default.
2

Open the dashboard

Navigate to the Nora dashboard in your browser. In local mode, the default URLs are:
URLWhat it opens
http://localhost:8080Entry page
http://localhost:8080/loginLog in
http://localhost:8080/signupCreate an operator account
http://localhost:8080/app/dashboardSystem overview
http://localhost:8080/app/deployDeploy your first agent
If you configured a public domain during setup, the same paths apply on your origin — for example, https://app.example.com/app/dashboard.
3

Create an account or log in

Go to http://localhost:8080/signup and create your operator account. If you set DEFAULT_ADMIN_EMAIL and DEFAULT_ADMIN_PASSWORD during setup, that account is already created — go to /login and use those credentials instead.
4

Add an LLM provider key

Open Settings in the dashboard. Add an API key for a supported provider such as Anthropic, OpenAI, or Google. Nora encrypts provider keys at rest with AES-256-GCM and stores them centrally so you can sync them to any running agent at any time.
Start with one key to validate the end-to-end flow. You can add more providers later from the same Settings page.
5

Deploy your first agent

Go to Deploy and fill in the deployment form:
  1. Enter an agent name
  2. Choose a runtime mode
  3. Set CPU, RAM, and disk resource limits
  4. Click Confirm & Deploy Agent
The agent will provision and start within a few seconds.
OpenClaw is the best-supported runtime today and the recommended choice for your first deployment.
6

Validate the agent

Open the agent detail page and work through the following checks:
  1. Confirm the agent shows a running status
  2. Click Sync Keys if you need to push your provider keys to the running runtime
  3. Open Chat and send a test message to confirm the LLM connection is working
  4. Click Logs and inspect the output to confirm the runtime is healthy
  5. Open Terminal to confirm you have an interactive session
If all five checks pass, Nora has demonstrated its core value — a single surface for deploying, observing, and operating an agent runtime.

​
What’s next

Deploy an agent

Learn how to configure runtimes, resource limits, and deployment options in depth.

Manage LLM providers

Add more providers, rotate keys, and control which agents have access to each key.

Connect integrations

Wire GitHub, Slack, Jira, AWS, and other tools to your running agents.

Monitor operations

Track agent health, LLM usage, costs, and runtime activity in real time.