[]
reArray
Documentation

Quick Start

Create a workspace, add a platform, configure an agent, write a task, and run your first automation.

This walkthrough takes you from an empty workspace to a completed execution in about fifteen minutes.

Prerequisites

  • A reArray account with access to a team workspace
  • A website you want to automate (for example, a login page you can test against)

Step 1: Create or join a workspace

Sign in and create a team workspace, or accept an invitation to an existing one. All reArray automation features live under Home → your workspace (/home/your-team).

Personal accounts do not include agents, tasks, or platforms — use a team workspace for automation work.

Step 2: Add a platform

  1. Open Platforms in the sidebar.
  2. Click New platform.
  3. Fill in:
    • Name — A human-readable label (for example, "Customer Portal").
    • Handler — A short identifier used in DSL scripts (for example, portal). Handlers must be unique within the workspace and use lowercase letters, numbers, and underscores.
    • URL — The starting URL for this platform (for example, https://portal.example.com/login).

Save the platform. You will reference it in tasks as in portal { ... }.

Step 3: Create an agent and attach the platform

  1. Open Agents and click New agent.
  2. Give the agent a name and configure concurrency if needed (defaults work for a first run).
  3. In the agent settings, attach your platform:
    • Select the platform you created.
    • Add credentials to the vault — for example, username and password fields. These are encrypted and available in DSL as $secrets.username and $secrets.password inside in portal { ... } blocks.

Save the agent.

Step 4: Write a task

  1. Open Tasks and click New task.
  2. Link the task to your platform.
  3. In the DSL editor, write a minimal script:
flow {
  in portal {
    wait visible { css "#login-form" } timeout 30000
    fill { css "#username" } $secrets.username
    fill { css "#password" } $secrets.password
    click { css "button[type='submit']" }
    wait visible { css "#dashboard" } timeout 30000
    extract { css "#welcome-message" } as welcomeMessage
  }
}

Adjust selectors to match your target site. The editor validates syntax as you type.

  1. Save the task. Each save creates a new version so you can roll back if needed.

See the DSL Reference for the full language guide.

Step 5: Run the task

  1. From the task detail page, click Run.
  2. Select the agent you configured.
  3. If your task defines parameters, fill in the params form (optional for this example).
  4. Confirm to queue the execution.

Step 6: Watch the execution

  1. Open Executions in the sidebar.
  2. Find your run — status progresses from queued → running → completed (or error if something failed).
  3. Click the execution to open the viewer:
    • Live stream while the run is active
    • Video replay after completion
    • Error details with the DSL fragment that failed, if applicable

What's next