DevSpace CLI v1.0
Deploy, manage, and monitor your applications in the cloud with ease. Deploy any project to a containerized environment in seconds, without complex configuration.
Introduction
📦 DevSpace CLI — A powerful command-line tool that lets you deploy, manage, and monitor your applications in the cloud with ease. DevSpace automatically detects your project type, selects the appropriate Docker image, and handles the entire deployment process.
Installation
Install DevSpace CLI with a single command. The installation script will download the binary and make it globally accessible.
curl -fsSL https://shulker.in/devspace/install.sh | sed 's/\r$//' | sudo bash
✅ What this does — Downloads the DevSpace binary from the official CDN, installs it to /usr/local/bin/devspace, and makes it globally accessible.
Verify Installation
devspace version
Authentication
Before deploying your first project, authenticate with your Shulker account. Credentials are stored locally with secure permissions.
devspace authenticate [email protected] mypassword # Aliases devspace auth [email protected] mypassword devspace login [email protected] mypassword
🔐 Credential Storage — Credentials are stored in ~/devspace-core/config.json with secure file permissions (0600). You only need to authenticate once per machine.
Deployment
Deploy your project to the cloud with automatic language detection and Docker image selection.
devspace deploy # Deploy specific directory devspace deploy ./my-app # Deploy with custom server name devspace deploy ./my-app my-server # Deploy for a team devspace deploy --team-id=123
| Parameter | Description | Default |
|---|---|---|
| directory | Path to your project directory | current directory |
| server-name | Custom name for your DevSpace server | auto-generated |
| image | Docker image to use for the container | auto-detected |
| team-id | Team ID for team deployment (higher quota) | individual |
Management
Command Execution
devspace execute my-server ls -la /project devspace exec my-server npm install devspace cmd my-server python app.py # Aliases: exec, cmd
⚡ Real-time Output — The execute command streams output in real-time as the command runs, providing live feedback from your container.
Container Control
⚠️ Deletion Confirmation — The delete command requires confirmation. You must type yes to proceed. This action is permanent and cannot be undone.
Limits & Quotas
📊 Quota Reset — All daily deployment quotas reset at midnight UTC. Project size limit: 500 MB (compressed). Directories like node_modules, .git, and __pycache__ are automatically excluded.
Supported Languages
📦 Custom Docker Images — Don't see your stack? Specify any Docker image: devspace deploy ./my-app my-server custom-image:latest
Quick Reference
Important Notes
📁 Excluded Directories — Automatically excluded: node_modules, .git, __pycache__, vendor, target
🔌 Port Forwarding — Port 8080 is automatically forwarded and made accessible via a public URL. The URL is displayed after successful deployment.
📂 Project Directory — Your project files are uploaded to /project inside the container. Use this path when executing commands.