Quick answers to the questions people ask most often. For step-by-step guides, see the Quickstart and the other pages in this documentation.
Accounts and login
How do I sign up?
Go to the sign-up page, enter your email and a password, and click Sign Up. If you are asked to confirm your email, open the link we send you before logging in. See the Quickstart.
Can I change or reset my password?
The password-reset page currently shows "Under construction. Please contact support." If you are locked out, contact whoever administers your ORC8R deployment.
Organizations and projects
What is the difference between an organization and a project?
An organization is the top-level entity, like your company. A project is a workspace inside an organization, such as "Development" or "Production". An organization can contain many projects. See Organizations and Projects.
What is the difference between a project and a pool?
A project contains one or more pools. A pool is a group of identical nodes (same provider, same size, same apps) created by a single request. See Pools.
Where do I find and change my organization's limits?
Open Orgs, select your organization, and open Resource Limits. It caps the number of projects, pools, and nodes. Only organization owners can change limits; members can view them.
Why can't I update the limits, add members, or change billing?
Those actions are reserved for organization owners. If you are a member you can view them but not change them. Ask an owner to make the change or to promote you.
Nodes and pools
What is a node, and what is the agent?
A node is a single machine you run software on. The agent is a small program ORC8R installs on every node so the machine can connect back, report its status, and receive apps. See Nodes.
What happens when I click "New Request"?
You enter a short wizard that defines a pool: you pick a project, optionally choose apps, choose where the nodes run, name the pool, and submit. ORC8R then creates the nodes. See Pools.
How do I scale my pool from 1 to 3 nodes?
On the Nodes page, find the pool and click its Size badge. In the Resize dialog set the number to 3 and click Apply. ORC8R adds nodes to match. (Self-hosted pools work differently — you connect machines yourself.)
Why won't it accept a pool name like "My Pool"?
Pool names must be URL-friendly: use lowercase letters, numbers, and dashes, for example my-pool-1.
Why is my node stuck and not reaching "online"?
Open the node by clicking its name and check the Logs tab. Also make sure your organization has not hit its node limit (see Organizations). The states a node passes through are explained in Nodes.
What does "baking" mean?
For some providers, ORC8R first builds a reusable image of a fully set-up machine, then boots every node in the pool from it. Building that image is called baking, and a node shows the state baking while it happens. See Pools.
How do I connect my own machine?
Use a self-hosted pool: open it, click Connect, and run the one-time install command it gives you on your machine. See Providers.
How do I view a node's logs?
Click the node's name in the Nodes list, then open the Logs tab. There is also a browser Terminal tab for troubleshooting — but any changes you make there are lost if the node is rebuilt.
Exporting and reporting
How do I export my node list?
On the Nodes page, apply any filters you want, then click Export. This downloads a nodes.csv file of the nodes currently shown.
API keys and automation
Where do I find my API key?
Open your Profile (your name or avatar, top right) and go to the API Keys section. See API keys.
Can I delete an API key?
Yes. In the API Keys section of your Profile, each key has a Delete button. A deleted key stops working immediately, so create a replacement first if something still depends on it.
What happens when my key expires?
It stops authenticating requests. Create a new key in your Profile to continue.
Troubleshooting
I terminated or rebuilt a node — what happens?
For managed pools, rebuilding replaces the node with a fresh one so the pool keeps its size. For self-hosted or one-off pools, terminating removes the node for good. If a node fails, check its Logs tab first.
My screen is blank or data isn't loading.
Refresh the page. If the problem continues, check your network connection, and on ORC8R Cloud you can reach us from the Support page.