Installation & Setup
System Requirements
| Platform | Minimum | Recommended |
|---|---|---|
| macOS | macOS 12 (Monterey), Apple Silicon or Intel | macOS 14+, M1/M2/M3 |
| Windows | Windows 10 64-bit | Windows 11, 16GB RAM |
| Linux | Ubuntu 20.04 / Debian 11 / RHEL 8 | Ubuntu 22.04+ |
| RAM | 4 GB | 8 GB+ |
| Disk | 500 MB | 2 GB+ |
| Network | Outbound HTTPS (443) | — |
Atlas Studio requires outbound internet access on port 443 to reach the Atlas Control Plane for license validation and AI inference. All connections are initiated by the IDE — no inbound ports required.
Download
Visit atlastechlab.com/studio/downloads or download directly:
| Platform | File | Size |
|---|---|---|
| macOS (Apple Silicon) | AtlasStudio-1.0.0-beta-arm64.dmg | ~180 MB |
| macOS (Intel) | AtlasStudio-1.0.0-beta-x64.dmg | ~185 MB |
| Windows (x64) | AtlasStudio-Setup-1.0.0-beta-x64.exe | ~175 MB |
| Windows (ARM64) | AtlasStudio-Setup-1.0.0-beta-arm64.exe | ~170 MB |
| Linux (AppImage) | AtlasStudio-1.0.0-beta-x86_64.AppImage | ~190 MB |
Installation Steps
macOS
macOS
Download the DMG
Download the appropriate .dmg for your Mac:
- Apple Silicon (M1/M2/M3) →
AtlasStudio-1.0.0-beta-arm64.dmg - Intel Mac →
AtlasStudio-1.0.0-beta-x64.dmg
Not sure which? Click Apple menu → About This Mac → Chip.
Open the DMG
Double-click the downloaded .dmg file. A window opens showing the Atlas Studio icon and your Applications folder.
Drag to Applications
Drag Atlas Studio to the Applications folder.
Launch Atlas Studio
Open Finder → Applications → Atlas Studio. Right-click → Open (first launch only, to bypass Gatekeeper).
Activate your license
On first launch, you’ll be prompted to sign in with your Atlas Studio account or enter a license key. See Authentication & Licensing.
Gatekeeper warning on first launch: macOS may show “Atlas Studio cannot be opened because it is from an unidentified developer.” Right-click the app → Open → Open. This only happens once. We are in the process of obtaining Apple notarization.
First Launch Checklist
After installing and launching Atlas Studio:
- Sign in with your Atlas Studio account (or enter license key)
- Complete the onboarding wizard (takes ~5 minutes)
- Add your first connector (Kubernetes, Datadog, etc.)
- Set your AI model preference (Fast / Balanced / Deep)
- Try the Coding Agent with a simple prompt
Proxy and Firewall Configuration
If you’re behind a corporate proxy or firewall:
Proxy setup
Set these environment variables before launching Atlas Studio:
# macOS / Linux
export HTTPS_PROXY=https://proxy.company.com:8080
export HTTP_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1
# Windows (PowerShell)
$env:HTTPS_PROXY="https://proxy.company.com:8080"
$env:HTTP_PROXY="http://proxy.company.com:8080"Or configure in Atlas Studio → Settings → Network → Proxy.
Required outbound endpoints
| Endpoint | Port | Purpose |
|---|---|---|
atlastechlab.com | 443 | License validation, updates |
studio.atlastechlab.com | 443 | Web Portal API |
*.anthropic.com | 443 | AI inference (if using Balanced/Deep) |
*.openai.com | 443 | AI inference (if BYOM with OpenAI) |
Uninstalling
macOS
# Remove the app
rm -rf /Applications/Atlas\ Studio.app
# Remove user data (optional — this deletes your local database and settings)
rm -rf ~/Library/Application\ Support/Atlas\ Studio
rm -rf ~/Library/Logs/Atlas\ Studio