Warning
Upgrading from 0.3.x or earlier still requires the manual migration. 0.4.1 has the same database schema, storage paths, and saved terminal selections as 0.4.0, so replacing the Terminals image alone does not upgrade a 0.3.x installation and there is no automatic migration. Back up both databases and all terminal files, then follow the 0.4.0 migration steps. From 0.4.0, replace the image as usual.
Warning
Restart now starts the workspace again. In 0.4.0, Restart only stopped a workspace, which started again on its next use. Restart now stops it and starts it again right away. If a script or runbook uses POST /restart to stop a workspace, for example before copying files, change it to the new POST /stop.
Requires Open WebUI 0.13.4 or later. Start and Stop appear in Open WebUI versions that include them.
Added
- Start and stop a workspace.
POST /api/v1/terminals/templates/{id}/stopstops a workspace and keeps its files; it starts again on its next use.POST /api/v1/terminals/templates/{id}/startstarts it, creating it if needed. Both take the sameuser_id,chat_id, andmodel_idbody as restart. - The built-in admin UI shows Start, Stop, and Restart. A running environment has Restart and Stop; a stopped one has Start.
Changed
- Restart starts the workspace again right away, with the current template settings. A new image, resource limit, or Open Terminal setup script takes effect without waiting for the workspace to be used.