Instances & Console

Restarting, stopping and removing an instance

How to restart, stop, or permanently remove an instance from the Console, and which actions are permission-gated.

Where to find these actions

Open the instance in the Console. The quick action buttons sit directly under the instance header: Restart, Connect, Merge, Stop, and (on non-production instances) Remove.

Restarting an instance

Click Restart to open the Restart Instance dialog. It offers two options:

  • Soft Restart: restarts Odoo and upgrades modules. Use this after deploying code changes when you want your module updates applied.
  • Hard Restart: restarts the Docker container. Use this when the instance is unresponsive or you changed settings that are applied on the next instance restart (for example environment variables or extra repositories).

Pick one and the job is queued. You can follow its progress and log in the Queue tab, see Deployments and the job queue.

Stopping an instance

Click Stop to stop the instance. The status indicator in the header will show it as offline. Note that if Auto Restart is enabled in the instance settings, a stopped or failed instance is restarted automatically; a banner at the top of the console tells you which situation applies.

Removing an instance

Remove is only available on Staging and Development instances. Production instances do not show a Remove button.

  1. Click Remove.
  2. Read the warning: this permanently deletes the instance and all its data.
  3. Type DELETE (in capitals) in the confirmation field. The Remove button stays disabled until the text matches exactly.
  4. Click Remove. After the removal is queued you are redirected to the project settings page.

There is no undo. If you might need the data later, download a backup first, see Backups and restore.

Permissions for workspace members

If you use the instance inside a workspace, each of these actions is controlled by a member permission. A member only sees a button when the matching permission is granted:

  • Restart requires the instance restart permission.
  • Stop requires the instance stop permission.
  • Remove requires the instance remove permission.
  • Connect and Merge are gated the same way by their own permissions.

If a button you expect is missing, ask the workspace owner to update your permissions.

If you get stuck, open a support ticket from the Tickets page or the chat widget.

Still stuck? Open a ticket from the app or talk to an engineer.