Introduction
Runtm is a powerful deployment platform that makes it incredibly easy to deploy applications directly from your AI coding environment. When combined with Claude Code, you get a seamless workflow that takes you from code to production in minutes.
Prerequisites
Runtm CLI installed
Install via npm: npm install -g runtm
Claude Code or Cursor IDE
Your AI-powered coding environment
A project to deploy
Can be a Next.js app, backend service, or static site
Getting Started
Initialize Your Project
Start by initializing your project with Runtm. This creates the necessary configuration files.
You'll be prompted to select a template: backend-service, static-site, or web-app. Choose the one that fits your project type.
Review Generated Files
Runtm creates several important files in your project:
- •
runtm.yaml- Your deployment manifest (port, health checks, resources) - •
Dockerfile- Container build instructions - •
public/health- Health check endpoint - •
runtm.discovery.yaml- Service discovery configuration
Authenticate with Runtm
Before deploying, you need to authenticate with Runtm:
This will open your browser to complete authentication. Once done, you're ready to deploy.
Validate Your Configuration
Before deploying, it's good practice to validate your configuration:
This checks that your manifest is correct, your Dockerfile is valid, and your health endpoint works.
Deploy to Production
Now for the magic moment - deploy your app:
Runtm will build your Docker image, push it to their registry, and deploy it. You'll get a live URL in seconds!
The Complete Workflow
Here's the typical workflow when using Runtm in Claude Code:
Ask Claude Code to create your application
Claude generates the code and project structure
Ask Claude to initialize Runtm: "Initialize this with runtm init"
Claude runs the init command and reviews the generated files
Ask Claude to deploy: "Deploy this to runtm"
Claude validates and runs runtm up
Your app is live with a public URL!
Tips & Tricks
Use Natural Language
Claude Code understands commands like "deploy this" or "initialize runtm". You don't need to type exact terminal commands.
Iterate Quickly
Make changes and redeploy with "runtm up". Runtm handles incremental builds efficiently, so updates are fast.
Check Your Logs
Use "runtm logs" to view application logs and debug issues. You can also use "runtm status" to check deployment health.
Manage Costs
Use "runtm destroy [deployment-id]" to tear down deployments you're not using to avoid unnecessary costs.
Common Commands Reference
runtm initInitialize a new Runtm project
runtm loginAuthenticate with Runtm
runtm validateValidate configuration and Dockerfile
runtm upDeploy your application
runtm listList all your deployments
runtm logs [id]View logs for a deployment
runtm statusCheck deployment status
runtm destroy [id]Destroy a deployment
Ready to Deploy?
With Runtm and Claude Code, you can go from idea to deployed application in minutes. The combination of AI-powered coding and instant deployment makes building and shipping software faster than ever.
Try it out with your next project and experience the future of development workflows.