Technical reference

What Rootsy does, exactly: limits, behaviors and commands for each part of the product.

For agents: every page is also plain Markdown, and /llms.txt lists them all.

Your computer

  • Your computer

    Reference for a Rootsy computer: the OS and user, preinstalled software, the directory layout, what persists, and the ports and paths that belong to the platform.

  • Sleep and wake

    When a Rootsy computer sleeps, what wakes it, what survives, how to keep it awake for a long job, and when the workspace pauses.

  • Preview and testing

    Show your work in the workspace's Preview window with rootsy preview, open apps that need a real browser window, and check that a page works.

  • The rootsy command

    Reference for rootsy, the helper command on every Rootsy computer: each subcommand with its flags, output and exit codes.

  • Backups and Reset

    Automatic and manual backups of a Rootsy computer, pinning and retention limits per plan, what a restore replaces, and what Reset keeps and wipes.

  • Troubleshooting

    The error pages, banners and command messages you can see on Rootsy, each with its cause and what to do.

Run jobs

  • Jobs

    Run one-off and long-running jobs on a Rootsy computer, from its terminal or over MCP, and keep them alive through sleep.

  • Scheduled tasks

    Run a job on a timetable: a schedule sends a signed request to an endpoint on your Rootsy computer, which verifies it and does the work. Manage schedules from the workspace, the rootsy command or MCP.

Serve apps

  • Serve an app

    Serve a static site or a running app from a Rootsy computer through nginx on port 8090, deploy new versions safely, and the request limits that apply.

  • Addresses and custom domains

    Your Rootsy computer's address at <name>.rtsy.dev, connecting a domain you own with CNAME records from the workspace or over MCP, root domains and www, and what each status means.

  • Protect an app

    Add a password with nginx basic auth, or sign-in inside the app, since Rootsy doesn't put a login in front of what a computer serves.

From outside

  • Connect an AI tool with MCP

    Connect Claude, ChatGPT or another MCP client to Rootsy, then create and manage computers, run commands, read files back, and manage schedules and domains through its 29 tools.

Account

  • Organizations

    Personal accounts and organizations on Rootsy: creating one, inviting and removing members, what every member can do, and deleting it.

  • Plans and Runtime Credits

    What each Rootsy plan enforces (computers, memory, storage, domains, monthly Runtime Credits), what spends credits, what happens when they run out or a plan ends, and how to cancel.

  • Limits

    Every Rootsy limit that's the same on all plans: computer names, request deadlines and sizes, ports, schedules, MCP, uploads, backups, domains and organizations.

  • Security

    How Rootsy is put together, what it protects, what you must protect on your computer and in your apps, what Rootsy's systems can reach, and how to report a security problem.

  • Your data

    Where your files and backups live, how to download a copy, and what deleting a computer, organization or account removes for good.

  • Changelog

    Customer-visible changes to Rootsy by date, newest first: new features, changed behavior and fixes you would notice.