{"schemaVersion":"1","contentVersion":"2026-10-18.1","slug":"controls-factory","title":"Factory settings & machine controls","summary":"Rename a factory, choose its coding agent, manage machine resources, and understand deletion scope.","category":"Control reference","minutes":5,"prerequisites":["Open the named screen in Rumata. Available controls may depend on your account, permissions, and resource state."],"sections":[{"id":"factory-details","title":"Factory identity and coding agent","blocks":[{"type":"paragraph","text":"Open [Factory Settings](/guides/controls-factory#factory-details) from [Home](https://app.rumata.dev/) or the workspace header. Existing factories also have editable name and description fields."},{"type":"table","headers":["Control","What it does"],"rows":[["Frontend source → Source","On [Home](https://app.rumata.dev/), choose whether to create a new Rumata frontend or work on frontend code already in the connected repository. The new-frontend option creates an owned folder for the factory. Review this choice before saving settings."],["Factory name / Description","Edit how the factory is identified. Both values are required when editing an existing factory. [Save settings](/guides/controls-factory#factory-details) applies the changes."],["OpenCode","Choose Rumata’s managed coding-agent option, which uses Rumata-managed models and platform AI credits."],["Restart after agent change","When changing the coding agent on an active machine, choose whether to restart it so the new agent can take effect. Saving with restart interrupts that machine’s current work."],["Save settings / Save & restart machine","Save the selected factory settings. The label changes when the save also restarts the machine. Read it before confirming."],["Cancel / Close","Dismiss the dialog without applying unsaved field changes."]]}]},{"id":"persistence-idle","title":"Workspace persistence and idle timeout","blocks":[{"type":"paragraph","text":"A [development machine](/guides/development#machine) is the environment used to build and preview the product. Its shutdown behavior matters even when a deployed frontend continues to run."},{"type":"table","headers":["Control","What it does"],"rows":[["Auto-save workspace changes","Enable committing and pushing workspace changes when the machine shuts down. Turn it off only when you intend to manage that source-saving step yourself."],["Stop an idle machine after","Choose an idle interval from the options allowed by the plan. Editor, terminal, file, build, and chat activity reset the timer. Saving changes this account-wide timer, even though the control appears in [Factory Settings](/guides/controls-factory#factory-details)."],["Default / plan maximum labels","Identify which idle option is the account default and which is the longest allowed interval. These are explanatory labels, not separate settings."]]}]},{"id":"machine-resources","title":"Development machine resources","blocks":[{"type":"paragraph","text":"Open [Development machine resources](/guides/controls-factory#machine-resources) in the workspace header. Wait for the live metrics to finish loading."},{"type":"table","headers":["Control","What it does"],"rows":[["CPU / Memory / Storage cards","Inspect current resource usage and health. Warning colors begin at 80%; critical starts at 95% or after an out-of-memory event."],["Machine size selector","Choose a supported machine size. Options may be disabled when the account does not have enough machine units."],["Apply size","Apply a different selected machine size. Rumata saves workspace changes before applying the replacement. Chat, preview, and editor connections can be interrupted while the environment changes. The button is disabled when the selection is unchanged or unavailable."],["Refresh","Fetch current resource metrics without changing the machine size."],["Restart machine","Open restart confirmation. The final [Restart machine](/guides/controls-factory#machine-resources) saves workspace changes and replaces the running machine; Chat, preview, and the editor reconnect afterwards. Cancel returns to metrics without restarting."],["Close","Dismiss the metrics dialog. Closing the dialog does not stop the machine."]]}]},{"id":"factory-delete","title":"Delete factory confirmation","blocks":[{"type":"paragraph","text":"[Delete](/guides/controls-factory#factory-delete) opens a confirmation. Review it before continuing. Opening or cancelling the dialog leaves the factory unchanged."},{"type":"table","headers":["Control","What it does"],"rows":[["Delete everything this factory owns","Choose whether deletion also removes owned resources. It is selected by default. The listed scope includes workflows and runs, database schema and saved queries, file storage, secrets, production frontend, and the Git frontend folder."],["Factory name to confirm","Enter the exact factory name shown, without quotation marks. The final action stays disabled until the required confirmation matches."],["Delete factory and everything / final delete action","Perform the irreversible deletion with the selected scope. The active [development machine](/guides/development#machine) is stopped before deletion."],["Cancel","Abort deletion and return to the prior screen or settings dialog."]]}]}],"technical":[],"related":["workspace","development","controls-home-account","controls-billing"],"sources":["Live Home Factory settings dialog, September 8 2026","Live factory settings, deletion confirmation, and development-machine dialog, September 6 2026","kondor_frontend/rumata_studio/src/components/chat/FactorySettingsDialog.tsx","kondor_frontend/rumata_studio/src/components/workspace/DevMachineResourcesDialog.tsx","kondor_frontend/rumata_studio/src/components/chat/factory-settings/FactoryDeletionDialog.tsx"],"updated":"2026-09-06","audience":"general","media":[{"src":"https://docs.rumata.dev/media/factory-settings.png","width":672,"height":726,"alt":"Rumata Factory settings dialog with source and coding-agent choices, Cancel, and Save settings.","caption":"[Factory Settings](/guides/controls-factory#factory-details) opened from [Home](https://app.rumata.dev/). Scroll for workspace persistence. [Save settings](/guides/controls-factory#factory-details) applies changes; Cancel leaves them unchanged.","sectionId":"factory-details"}],"video":null,"url":"https://docs.rumata.dev/guides/controls-factory"}