Edit an Application
Change an application's repository, build settings, or branch when the source or deploy setup changes.
Goal
Update application settings without creating a new application.
Prerequisites
- You can edit applications in this environment (
application:update) - The project and environment are already selected
- The application exists in that environment
What you need
Change only the fields that need an update.
Repository or source location
The git repository, or the folder inside a monorepo, that Devopness should build.
Source provider and credential
The git host and credential that can read the source.
Root directory
The folder that contains the package manager file for the application. Use a subfolder when the source lives inside a monorepo.
Default branch
The branch Devopness uses when a deploy does not specify another ref.
Install dependencies command / Build command
Custom commands only when the defaults no longer match your stack.
Using Devopness MCP
Try these prompts in Devopness MCP:
- "Update the
acme-apiapplication to use themainbranch" - "Change the repository for
acme-web" - "Update the build command for the application in Staging"
After you save
- The application stays the same in Devopness; only the updated fields change
- Existing linked resources stay attached unless you change them
- Deploy again if the changes affect runtime behavior
Verify
- The application details show the updated settings
- The repository, root directory, and commands match the new source layout
Common issues
- You cannot save changes: confirm you still have edit permission
- A field validation error appears: check the updated repository path or command text
- The application still uses the old settings: confirm you saved the change in the correct environment
What to do next
- View the application
- Deploy the application when the change affects runtime behavior
Required permissions
To follow this guide, you need the following permissions in the target environment.
| Resource Type | Required Permission |
|---|---|
| Application | Edit |
For instructions on how to grant user permissions to an environment, please follow the guide Add a team to an environment.