Coder Workspaces
Create, manage, and organize your cloud development environments.
Creating Workspaces
Quick Start
- Click Coder in sidebar
- Click Create Workspace
- Give it a name: "Backend API", "Frontend App", etc.
- Choose template (Node.js, Python, Go, etc.)
- Choose resource size:
- Small: 2 CPU, 4 GB RAM ($2.50/hr)
- Medium: 4 CPU, 8 GB RAM ($5.00/hr)
- Large: 8 CPU, 16 GB RAM ($10.00/hr)
- Click Create
Workspace starts in ~30 seconds.
Naming Conventions
Use clear names:
Good:
- "frontend-next-main"
- "backend-api-dev"
- "data-pipeline-q2"
- "alice-experimental"
Avoid:
- "workspace1", "test", "new"
- "tmp", "debug", "fix"
Workspace Resources
CPU and Memory
Choose appropriate size:
Small (2 CPU, 4 GB RAM):
✓ Web development
✓ Small scripts
✓ Light testing
✗ Large datasets
✗ Compiling heavy code
Medium (4 CPU, 8 GB RAM):
✓ Backend development
✓ Databases
✓ Testing
✓ Light data analysis
Large (8 CPU, 16 GB RAM):
✓ ML training
✓ Large compilations
✓ Heavy data processing
✓ Multiple services
Disk Space
Each workspace includes storage:
Small: 50 GB
Medium: 100 GB
Large: 250 GB
Disk usage shown:
Used: 25 GB / 100 GB (25%)
If you exceed:
- Stop workspace
- Clean up files
- Or upgrade size
Managing Workspaces
View All Workspaces
My Workspaces:
- backend-api (Running) - Started 2h ago
- frontend-app (Stopped) - 3 days ago
- data-analysis (Running) - Started 1h ago
Click any to:
- Open in browser
- Stop/start
- Share
- Delete
- See details
Workspace Details
Click workspace name to see:
Status: Running
Started: 2024-06-12 14:30 UTC
Uptime: 2 hours
Template: Node.js
Resources: 4 CPU, 8 GB RAM
Disk Used: 32 GB / 100 GB
Public URL: https://...
Workspace Status
- Starting - Launching (1-2 minutes)
- Running - Ready to use
- Stopping - Shutting down
- Stopped - Not running
- Error - Something wrong
Connecting to Workspaces
Browser IDE
Click workspace to open:
- URL opens automatically
- Full VS Code editor in browser
- Terminal at bottom
- File explorer on left
- Ready to code immediately
SSH Connection
Use local IDE instead:
# SSH into workspace
ssh coder@workspace-name
# Then use your local IDE
code .
# Or configure in VS Code settings
# Remote - SSH extension connects directly
See Coder SSH for details.
Templates
Using Built-in Templates
- Node.js - JavaScript, React, Express
- Python - Data science, ML, scripts
- Go - Backend, APIs
- Full Stack - All tools combined
Creating Custom Template
Create reusable starting point:
FROM coder/base:latest
RUN apt-get update && apt-get install -y \
nodejs \
npm \
postgresql-client
COPY package.json /tmp/
COPY package-lock.json /tmp/
RUN cd /tmp && npm install
COPY dotfiles /home/coder/.config/
USER coder
Then use for all new workspaces.
Auto-Stop and Billing
Auto-Stop Settings
Prevent wasting money:
- Click workspace
- Click Settings
- Set "Auto-stop after inactivity":
- 5 minutes (aggressive)
- 15 minutes (testing)
- 30 minutes (default)
- 1 hour (dev work)
- Never (uses resources)
Billing Impact
Resource: 4 CPU, 8 GB RAM
Cost: $5.00/hour
Scenario 1: No auto-stop
Work 8 hours, forget to stop: $40
Work 8 hours, leave running: $5/hour × 16 hours = $80
Scenario 2: Auto-stop at 30 min
Work 8 hours, AFK after: Stops after 30 min = $4.17
Small impact from auto-stop gap
Manual Control
Stop anytime:
- Click workspace
- Click Stop
- Work saved automatically
- No charges while stopped
Check Workspace Status
- Go to Coder
- See all workspaces
- Running = charging
- Stopped = no charge
Persistence
Your Work is Saved
Auto-save means:
- Files written to disk
- Databases persist
- Terminal history saved
- Git commits saved
- SSH keys saved
Stop workspace, restart later:
- Everything is there
- Open same files
- Continue where you left off
- $0 cost while stopped
Backup Your Work
Backup workspace to GitHub:
git add .
git commit -m "Save work"
git push origin main
Then work is backed up and:
- Restored on new workspace
- Accessible from anywhere
- Safe if workspace deleted
Sharing Workspaces
Quick Share
Share workspace with teammate:
- Click workspace
- Click Share
- Select team member
- Set permission (Edit/View)
- They can now open it
Pair Programming
Multiple people in same workspace:
- Same files visible
- See each other typing
- Shared terminal
- Chat for communication
Read-Only Access
Share for review:
- Set permission to View
- Can't modify files
- Can suggest changes via comments
Deleting Workspaces
Before Delete
- Backup work:
- Push to GitHub
- Download files if needed
- Stop workspace
- Delete
Delete Process
- Click workspace
- Click Delete
- Confirm (can't undo!)
- Workspace removed
- Files gone, no more charges
Troubleshooting
Workspace won't start
- Check resource limits
- Wait 2 minutes
- Refresh page
- Restart browser
- Contact support
Running out of disk space
Options:
1. Clean up files
2. Upgrade workspace size
3. Split into multiple workspaces
4. Archive old projects
Connection issues
- Check internet connection
- Refresh page
- Close other browser tabs
- Check firewall/VPN
Related Topics
- Coder Overview - What is Coder?
- Coder Teams - Team collaboration
- Coder SSH - Use local IDE
- Coder Billing - Understand costs