Hey, no problem. The Dockerfile setup is done in .cursor/environment.json in the repo root. The basic structure is:
{
"build": {
"dockerfile": "Dockerfile",
"context": ".."
},
"install": "bash .cursor/install.sh",
"start": "bash .cursor/start.sh",
"terminals": []
}
build.dockerfileis the path to your Dockerfile relative to.cursor/build.contextis the build context, usually..which is the repo rootinstallis the command to install dependenciesstartis the command to start servicesterminalsis optional, preset terminals that show up in the Cloud Agents window
After you commit .cursor/environment.json and the Dockerfile, the agent will pick up the config and build the environment. Full docs: Cloud Environment Setup | Cursor Docs
If you plan to run Docker inside the agent docker-in-docker, add fuse-overlayfs and iptables-legacy in the Dockerfile, and make sure the cloud agent user has permission to run Docker. That’s covered in the Running Docker section at the same link.
A couple threads with working examples and common gotchas:
Let me know if anything isn’t getting picked up. Share your environment.json and the build log and we can take a look.