Administration

# Environment Management

Manage development environments and configurations

⏳ Loading...
🌍

## Select an Environment

Choose an environment from the tabs above to view and manage its configuration

## -

### Environment Information

Description
Default Agent
Skills
No skills assigned.
Docker Image
Timezone
Screen Render URL

### README

No README content yet.

📦
-
Repos
✅
-
Test Commands
📝
-
Templates
-
Deploy Profiles

#### Select a Repository

Select a repository from the sidebar to view details, or add a new one.

### App Server

Server Name
Start Command(s)
Shell commands to start the application server. Use multiple lines for complex startup sequences.
Proxy URL
QA URL Use `{{origin}}`, `{{host}}`, or `{{hostname}}` for dynamic resolution

#### Port-Specific QA URLs

Override the default QA URL for specific ports (e.g., port 3001 → https://production.example.com)

#### Basic Authentication

Load HTTP Basic credentials from secrets (must have `available_for: ['tasks']`)

User Secret Name
Password Secret Name

#### Proxy Headers

#### Ports

#### Launch URLs

Mark one URL as Primary to open it when users click the Testing button in tasks.

#### Volume Mounts

Mount host directories into containers for testing with host data

### Instructions (AGENTS.md)

### Schedule

Enable Scheduled Rebuilds

Automatically rebuild this environment's Docker image on a schedule

Rebuild Interval (hours)

### Scripts

Advanced

Optional scripts for customizing the build and task lifecycle. Leave blank to use defaults.

Docker build instructions to run BEFORE repositories are cloned. Docker build instructions to run AFTER repositories are cloned. Shell script that runs when a task container starts. Shell script that runs when a task completes.

### Build History

Build Output

Loading build history...

### Secrets

Show:

No secrets configured.

Secrets can be referenced in builds, tasks, and deployment profiles and exposed as environment variables or mounted files.

### External Connections

No external connections configured.

Add connections to external servers (SQL Server, IBM i, SSH) to auto-configure containers with database access, SSH keys, and build tooling.

#### Select a Test

Select a test from the sidebar to view details, or add a new one.

#### Select a Template

Select a template from the sidebar to edit, or create a new one.

#### Select a Profile

#### Deploying:

Running 0:00

Select a deployment profile to view details, or add a new one.

Deployment profiles define scripts that can be run to deploy your application to different environments (e.g., QA, Production).

Description

##### Deployment Script

Reference secrets from the Secrets tab to expose as environment variables or mounted files.

User-provided values prompted when running this deployment.

### Automations

0 items
Loading automations…

No automations configured for this environment.

Create one to run tasks on a recurring schedule.

Name | Schedule | Enabled | Actions
--- | --- | --- | ---

####

Date | Trigger | Status | Task
--- | --- | --- | ---

### Environment Access

Loading bindings…
No access bindings for this environment.

Subject | Type | Role | Granted By | Date | Actions
--- | --- | --- | --- | --- | ---

Type
Team / User
Role

## Create Automation

#### General

Name
Description

#### Schedule

Frequency
Time
Day of Week
Time
Day of Month

Days 29-31 are excluded so monthly schedules stay valid in every month.

Time
Every
Between (optional)
to
Days (optional)
Cron Expression

#### Agent

Agent
Effort Level
Reasoning Level

#### Task Configuration

Task Name Template
Task Source
Custom instructions Use task template
Task Template
Instructions
Enabled

## Commit Changes

Committing as: <>
Modified files:

Commit message
Pull latest changes before committing (recommended) Push to remote immediately

## Uncommitted Changes

The following files have uncommitted changes. Click a file to view its diff.

## ⚠️ Discard Changes

This will permanently discard all uncommitted changes.

This action cannot be undone.

Files that will be affected:

## 📦 Build Environment

Build environment ?

This will rebuild the Docker image with `--no-cache`. The build process typically takes a few minutes.

## Base Image Required

This environment cannot be built yet because no base image is available.

Build the base image first using Actions -> Build Base Image.

## Generated Dockerfile

This Dockerfile is automatically generated based on your environment configuration. It includes repository cloning, authentication handling, and your custom build commands.

## Build Base Image

This will rebuild the foundational image that all environment images are based on. The build typically takes several minutes.

Build without cache (--no-cache)

#### Build History

Loading...

## Create New Environment

Environment Name *
Description
Repository
None Enter URL manually Select from provider
Repository URL Will auto-configure Dockerfile, setup.sh, and agent instructions
Git Provider
Repository *
Credential Mode
For tasks and deployments. App: app/bot identity. User: personal Git account (requires connection).
Docker Image *
Default Agent *

## ⚠️ Delete Environment

This will delete the entire environment directory.

All configuration files and uncommitted changes will be removed.

Environment to delete:

## Assign Skills

Search and select skills to make them available to agents in this environment.

Search skills
Loading skills...

#### Selected Skills

0

No skills selected yet.

Manage Skills

## Rename Environment

Current Name
New Name *

## Add Repository

Repository
Enter URL manually Select from provider
Git Provider
Repository
Credential Mode
For tasks and deployments. App: app/bot identity. User: personal Git account (requires connection).
Repository URL
Name
Branch
Allow Branch Selection
Path
Description

## Delete Repository

Are you sure you want to remove this repository from the environment?

This will only remove the repository configuration, not delete any files.

## Add Test Command

Test Name
Description
Command(s)

## Delete Test Command

Are you sure you want to remove this test command?

## Add Task Template

Title
Description
Filename

## Delete Template

Are you sure you want to remove this template?

## Add Deployment Profile

Profile Name

Alphanumeric, hyphens, and underscores only

Description

## Run Deployment:

Dry run (validate only, don't execute)

## Delete Deployment Profile

Are you sure you want to delete this deployment profile?

This will delete both the profile configuration and its deployment script.

## Add Secret

Secret Name *
Description
Source Type *
File on host Direct value
Available For *
Build Tasks Deploy
Expose As *
Environment Variable File (bind mount)
Variable Name * The environment variable name
Host File Path * Absolute path, or relative to the environment directory
Value *
Use as Git PAT (Personal Access Token) Use this secret as a PAT for authenticating with a Git host
Git Host *
Custom Git Hostname * The hostname of your Git server (without https://)

## Delete Secret

Are you sure you want to delete this secret?

Deployment profiles referencing this secret will need to be updated.

## Add Connection

Connection Name *
Description
Available For *
Tasks Deploy
Type *
SQL Server IBM i SSH
Host *
Enter the fully qualified host name, e.g. myserver.mycompany.com
Verify DB server certificate Disabling certificate verification exposes the connection to man-in-the-middle attacks. Only uncheck this if you understand the security implications.
Database *
User *
Password *
How to set up IBM i user profile
IBM i Features *
SQL Build objects SSH Sync Agent interactive sessions
Build Repo *
Repository where codermake runs
Build Directory Subdirectory within the repo (leave blank for repo root)
Build Library Name Prefix * Used as task build library name prefix
SSH Private Key *
SSH Public Key
PUI Base URL *
Enter the fully qualified URL, e.g. https://myibmi.mycompany.com:8080
PUI Render Path
PUI Launch Path
Testing...

## Delete Connection

Are you sure you want to delete this connection?

Containers will no longer have access to this external server.

## Install Public Key on Remote

Enter the password for the remote host. It will only be used to install the public key and will not be saved.

Password *

## IBM i User Profile Setup

Run the following CL commands on the IBM i system as a sys admin:

Notes:

- Configure the user's JOBD or initial program to set the appropriate library list
- For interactive sessions, make sure that PUISETENV is called as or from the user's initial program
- SSH public key installation is handled separately via the connection UI

## Add Secret to Profile

Secret *
Select a secret defined in the Secrets tab (only secrets available for Deploy are shown)

## Configure Parameter

Parameter Name * Will be available as environment variable when running
Display Label User-friendly label shown in the run dialog
Description
Input Type *
Options *
Define the available choices. Use description for additional context.
Command * Shell command to run in container to generate choices
Output Parser
Repositories Optional: specific repos to update before running command
Directory Path * Directory path relative to /workspace
Include
Glob Pattern Optional file pattern filter
Repositories Optional: specific repos to update before listing
Allow multiple selections
Default Value
Required field

## Git Connection Required

Connect your account to the following Git provider to continue: