Environment Configurations

Before you can deploy a pipeline in Salus, you need to configure an environment. Environments allow you to separate testing, staging, and production contexts, each with its own data sources, secrets, runtime settings, and access controls.

Environments

Environments in Salus are isolated contexts where pipelines are deployed and executed. Each environment has its own data connections, runtime settings, secrets, and access controls, allowing teams to safely test, stage, and run pipelines across different stages of development.

Think of environments as containers for running your pipelines under specific conditions, so that what happens in development doesn’t affect production.

Each environment also chooses its region when it’s created, so one organization can run environments across several regions and clouds at once.

New Environment Configuration

Select/Create an Environment

To configure an environment you need to select from the existing list of environments. Only environments that are not already configured will show up.

By default, each workspace is provided with a single environment named Production.

You can create a new environment by clicking on the drop-down and clicking “Add new environment”.

Choose the environment’s region — where its workloads will run. Your organization’s default region is pre-selected, and each option is labelled with its provider.

Select a Deployment Strategy

You can either use branches or target tags as per your preferred deployment strategy. Ensure the available tags or branches are available in the connected Git repository.

Assign Compute Resources

You can assign compute resources for your application by selecting from the list of pre-defined memory and CPU sizes and, min and max number of instances.

🎉 Ready for Deployments

You can set up additional configurations or choose to default to Salus’ configuration for a quick setup. At this point your environment is ready for deployments.

Manage Additional Configurations

Automated Deployments

You can decide if you want your applications to be automatically or manually deployed if a pipeline is run. This is always enabled by default.

Runtime & Buildtime Variables

Manage the environment variables your application needs from each environment’s configuration. Each variable can be available at runtime (to your running app), at build time (during the build), or both.

• Secrets — mark sensitive values such as API keys and database passwords as secrets. Salus stores them securely and masks them in the UI.
• Files — a value can be exposed as an environment variable or mounted as a file, for config your app reads from disk.

Where variables are set

Variables can be defined at four levels, and a deployment inherits them all merged together. When the same key is set at more than one level, the level closest to the deployment wins:

Organization → Workspace → Project → Release configuration — later overrides earlier.

So you can set a shared value on the organization and override it for a single environment’s release configuration.

Example

For a Node.js service you might set:

Networking

Port

You can define your port, Salus will always default to 8080

Public Network

You can enable Expose application to public. This allows access to your application over the public internet — anyone with the URL will be able to reach it. See Access Control for more on public versus private exposure.

Domains

Whenever an application is exposed to the public, Salus assigns a free domain for it. You can also configure a custom domain.

Danger Zone

Change your Deployment Strategy

You can update your deployment strategy in the Danger Zone.

Delete Configuration

You can delete deployment configurations.

Delete an Environment

You can delete an environment you no longer need — a preview, a spike, or an old staging setup — from your workspace’s environments list. The option appears only if your role allows deleting environments, and you’ll be asked to type the environment’s name to confirm.

Before you confirm, Salus checks whether any projects are still running in the environment and tells you what it finds — environments are shared across a workspace, so more than one project can be live in the one you’re deleting.

This is different from deleting a configuration (above), which removes a single project’s setup for an environment. Deleting the environment itself removes it for every project in the workspace.

Troubleshooting

• A variable change isn’t taking effect. Changes apply only after the deployment is redeployed — trigger one and check again.
• Can’t create a variable starting with SALUS_. That prefix is reserved for values Salus injects (like linked-database credentials) and is blocked on your own variables.
• The app is deployed but unreachable. Check that Expose application to public is enabled if you’re connecting from the internet, and that the configured port matches what your app listens on (Salus defaults to 8080).
• The region you want isn’t offered when creating an environment. Only regions enabled for your organization appear — an admin can enable it on the organization’s Regions page.