Availability
Entry points
- The edit button (Edit environment) on the right of Project settings › Environment.
- A notification about missing environment variables for a project, which opens the environment setup page directly.
Environment status
In Settings › Workspace › Projects, each cloud project shows its environment status:First setup
When you first open the environment setup page, AI generates a draft from the repository (setup script, start command, and the secrets and variables needed). It runs the setup script only after you finish the environment review.- When secrets or environment variables are missing, the Review environment card opens directly above the input box.
- When nothing is missing, click Edit environment above the input box to open the same card and confirm.
Three-step environment review
The Review environment card has three steps. Use Next and Skip to move forward, and click Finish review on the last step. When required items are missing, you can click Later to collapse the card into one line, Needs your input. Click it to expand again; the values you entered are kept.- Confirm setup and start: review the AI-generated Setup script (runs when the environment is created and when dependencies change) and Start command (runs after each wake-up). Click the edit button to change them.
- Configure secrets: fill in the value of each secret. Secrets already saved stay unchanged if left empty. Rows marked Workspace are suggested for the workspace level and are shared by projects in the workspace; other rows are saved as secrets for this project. Names can contain only letters, digits, and underscores, and cannot start with a digit.
- Configure environment variables: variables with a value suggested by AI are prefilled. You can change them or click Add variable. Saved variables do not show their values; leave a field empty to keep it.
After the review
After you click Finish review, the page shows the summary You finished the environment review (whether setup and start were changed, which secrets were saved, and the number of environment variables), and AI then runs the setup script on the cloud server with the confirmed script. Secret values are not shown on the page.Setup results
Environment ready
When the setup script passes, an environment card appears with my-app is ready, listing the repository, runtime, setup script, start command, secrets (those without a value are marked (missing)), and the number of environment variables.- Edit: reopens the review card so you can make changes and run it again.
- Publish to cloud server: after publishing, the card changes to my-app is published. Click Start a task to open the new session page with this project selected.
Setup failed
When the setup script does not pass, the error message is shown. Starting sessions is not affected:- Retry: runs the latest script again.
- Edit environment: change the script, then click Finish review to run it again.
Add more requests
After setup fails, is ready, or is published, you can send a request in the input box at the bottom of the page (Ask for follow-up changes), and AI sets up the environment again accordingly. You cannot send while setup is in progress, and you cannot change the model here.Change a published environment
Open the environment setup page from Project settings › Environment, click Edit environment, and click Finish review after your changes to run the setup script again. Once it passes, the project becomes Unpublished; click Publish to cloud server again for the changes to take effect. You can also change project-level secrets and variables directly in Settings › Workspace › Secrets & variables; see Workspace settings. After you delete a variable, running environments pick up the change after a restart.Notes and limits
- Do not send secrets directly in the input box of a session or the environment setup page. Enter them in the environment review or in Settings › Workspace › Secrets & variables.
- The cloud environment can only reach the public internet.
- Environment setup applies only to cloud projects on the cloud server.