Terminal
Terminal/Skill
Uses the Render CLI to deploy, tail logs, open SSH and psql sessions, validate Blueprints, and script deploys in CI.
By Render
Works with
npx skills add render-oss/skills --skill render-cliThe Render CLI manages services, databases, and deployments from the terminal. Supports interactive use, non-interactive scripting, and CI/CD automation.
Before installing, authenticating, selecting a workspace, or running commands, read references/render-access.md for the current access and command-discovery workflow.
render.yaml BlueprintUse the installed CLI help or generated command reference as directed by references/render-access.md for the exact command surface and flags. The patterns below cover common operational workflows.
# Deploy and wait for completion (exits non-zero on failure)
render deploys create srv-xxx --wait --confirm -o json
# Deploy a specific commit
render deploys create srv-xxx --commit abc123 --wait --confirm
# Deploy a specific Docker image
render deploys create srv-xxx --image ghcr.io/org/app:v1.2.3 --wait --confirm
# Single query, JSON output
render psql db-xxx -c "SELECT NOW();" -o json
# CSV output via psql passthrough
render psql db-xxx -c "SELECT id, email FROM users;" -o text -- --csv
name: Deploy to Render
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Install Render CLI
run: |
curl --fail-with-body --silent --show-error --location \
https://raw.githubusercontent.com/render-oss/cli/refs/heads/main/bin/install.sh \
--output /tmp/install-render-cli.sh
sudo sh /tmp/install-render-cli.sh
render --version
- name: Deploy
env:
RENDER_API_KEY: ${{ secrets.RENDER_API_KEY }}
run: render deploys create ${{ secrets.RENDER_SERVICE_ID }} --wait --confirm -o json
If reproducible builds require a pinned CLI, select a currently supported release and verify its asset name in the current release documentation instead of copying a version from this skill.
Config file: ~/.render/cli.yaml
Override the configuration directory with RENDER_CLI_CONFIG_DIR. RENDER_CLI_CONFIG_PATH is a legacy file-level override retained for compatibility and is scheduled for deprecation.
| Mistake | Fix |
|---|---|
Deploying without --wait in CI | Add --wait so the job fails on deploy failure |
| Document | Contents |
|---|---|
references/render-access.md | Current CLI authentication, workspace, documentation, output, and authorization workflow |
references/command-cheatsheet.md | Common operational command examples and scripting patterns |
render.yaml authoring and validationrender psql usagerender logs and render ssh for troubleshootingWhenever this skill directs you to consult current Render documentation:
curl. Do not substitute web-search summaries for the document.When a task requires multiple references, apply this workflow to each one and distinguish the documents you verified from those that remain unavailable.