Dev Machines
Isolated development environments for building and testing. Full Linux environments powered by Proyecta Cloud.
Proyecta provisions a dedicated development machine (runtime) for each project. This is an isolated container with a full Linux environment where your app runs during development.
How do dev machines work?
Section titled “How do dev machines work?”When you open a project, Proyecta:
- Creates an isolated container (pod) in the cloud
- Clones your code from GitHub
- Installs dependencies and sets up the environment
- Starts your app’s development server
- Shows a live preview in the builder
You can see provisioning progress in the Runtime Status Bar below the toolbar.
Provisioning Steps
Section titled “Provisioning Steps”The status bar shows these steps during startup:
| Step | Description |
|---|---|
| Creating pod | Spinning up the isolated container |
| Health check | Verifying the container is running |
| Git init | Cloning your repository |
| Environment setup | Installing dependencies (npm, pip, etc.) |
| Starting services | Launching your app and infrastructure |
| Ready | Your dev machine is fully online |
My dev machine is having issues. How do I fix it?
Section titled “My dev machine is having issues. How do I fix it?”If the preview isn’t loading or the machine seems stuck:
- Check the Runtime Status Bar for error messages
- Try using the Terminal to inspect logs
- If all else fails, ask the AI to help debug the issue
Infrastructure Services
Section titled “Infrastructure Services”Your dev machine can include sidecar containers for databases and services:
- PostgreSQL — Relational database (port 5432)
- Redis — In-memory cache (port 6379)
- MongoDB — Document database (port 27017)
- MySQL — Relational database (port 3306)
View running services and their status in the Services panel.
Lifecycle States
Section titled “Lifecycle States”Dev machines go through these lifecycle states:
| State | Description |
|---|---|
| Pending | Waiting to be created |
| Initializing | Setting up the environment |
| Running | Active and healthy |
| Suspended | Paused to save resources (resumes quickly) |
| Archived | Stored in cold storage (takes longer to restore) |
| Terminated | Permanently stopped |
Machines automatically suspend after 60 minutes of inactivity and archive after 24 hours of suspension.
If the dev machine goes down, what happens to my published app?
Published apps run on separate infrastructure. Dev machine issues don’t affect your live site.
Can I get a faster dev machine?
Paid plans get machines with more RAM, CPU, and longer timeout limits.
Can I access the dev machine directly?
Yes. Use the built-in Terminal for full shell access to your development environment.