Skip to main content
Installing or updating a module is always two steps: a plan, then an apply. The plan lists every change before anything is written.

​
What a plan says

Devias compares the manifest with what the workspace already has and marks each item as one of: Changes that delete data are destructive. Apply refuses them unless explicitly allowed.

​
Plan and apply in the studio

In Settings → Modules, open the module and its Install or Changes tab, and apply the plan there. In development, the studio applies plans that have no destructive changes and no conflicts by itself on start-up, and asks about the rest.

​
Plan and apply from the command line

The devias command does the same against a running server. It needs the workspace id, a manifest file and an API key.
A different server is set with -u or DEVIAS_URL (default http://localhost:3000).
Plan and apply need an API key that may manage modules. A key made in Settings → API keys can only read records, so create the key through the API with permissions: { "module": ["manage"] }.