michtio/craftcms-claude-skills / skills/craft-fortrabbit
craft-fortrabbit
Verifiedfortrabbit (fortrabbit.com) — managed PHP hosting with a Craft CMS software template. Covers git push-to-deploy through the fortrabbit GitHub App, the build and post-deploy commands of the Craft template (migrate/all, project-config/apply, clear-caches/all), the merge deployment strategy with the /config/project replace pattern, the deploy file (.fortrabbit/deploy.yml) and its replace-by-default trap, the CRAFT_* ENV vars mapped from FORTRABBIT_DB_* platform variables, production settings (dev mode, admin changes, updates off), the persistent storage for asset volumes and rsync sync, MySQL over SSH and an SSH tunnel, the Craft queue and image transforms in a worker job, crons, platform limits (no root, no sendmail, heavy binaries in jobs only), and DDEV local development.
fortrabbit — Managed PHP Hosting for Craft CMS
Reference for running Craft CMS 5 on fortrabbit (fortrabbit.com), a managed PHP hosting platform. Covers git deployment and the Craft software template, the deploy file, ENV vars, the persistent storage and asset volumes, MySQL access over SSH, the Craft queue and image transforms in worker jobs, platform limits, and local development with DDEV.
This skill is scoped to Craft on fortrabbit specifically: what differs from running Craft yourself on Forge or bare metal. For generic Craft deployment, see the craftcms skill's deployment.md. For Craft Cloud, see craft-cloud; for Servd, see servd.
Companion Skills — Load When Needed
craftcms— When the topic intersects plugin or module PHP (queue jobs, filesystem code, console commands).craft-site— When the topic intersects templates (transforms in Twig,{% cache %}tags).ddev— For local development; fortrabbit has no first-party local environment, DDEV is the common local stack.craft-plugins— For Blitz, Imager-X or other plugin configuration on a fortrabbit site.
Documentation
Authoritative sources (fortrabbit's own docs):
- Every page, listed: https://docs.fortrabbit.com/llms.txt
- Craft CMS guides: https://docs.fortrabbit.com/guides/craft-cms
- Platform: https://docs.fortrabbit.com/platform
- CLI, MCP server and agent skills: https://docs.fortrabbit.com/platform/automation
Any page is available as Markdown: insert /raw after the host and append .md, e.g. https://docs.fortrabbit.com/raw/guides/craft-cms/setup.md.
Current values beat this skill. Template commands, ENV vars and the deploy file format change over time. Read the live values before writing a deploy file or changing settings, fetching the docs pages with WebFetch: the environment itself (get_environment or frbit environments get <env> --json), the Craft setup page above (rendered from fortrabbit's platform definitions), and the deploy file page. See references/deploy-and-environments.md. Last verified against the docs on 2026-11-06.
What's Different on fortrabbit vs Self-Hosted
Each row is a place self-hosted habits will mislead you.
| Concern | Self-hosted | fortrabbit |
|---|---|---|
| Objects | One server | An app has one or more environments (en-xxxxxx), e.g. production and staging. Each has its own code, database, ENV vars, SSH access and default domain <env>.<region>.frbit.app |
| Deploy | Whatever you've wired | Git push to the connected branch, through the fortrabbit GitHub App. Composer runs in the build; post-deploy commands run once the code is live |
| Deploy config | Deploy script | The Craft software template sets root path web, build and post-deploy commands, strategy. Edit in the dashboard, or commit a deploy file .fortrabbit/deploy.yml |
craft up | Add it to the deploy script | Template post-deploy commands run migrations, project config apply and a cache clear |
| Filesystem | Local disk | Persistent storage: survives deployments and restarts. Local asset volumes work. The merge strategy keeps uploads in place |
| Env vars | .env on the server | Dashboard ENV vars per environment. The template maps CRAFT_DB_* to platform variables ${FORTRABBIT_DB_*}. No .env on the server |
| Production config | Yours to set | Template sets CRAFT_DEV_MODE=false, CRAFT_ALLOW_ADMIN_CHANGES=false, CRAFT_ALLOW_UPDATES=false |
| Database | Whatever you installed | MySQL only, one database per environment, reached from inside the environment or over SSH |
| Queue | Daemon via supervisor | Default web-triggered queue. A worker job in the jobs component runs php craft queue/listen |
| Cron | crontab | Cron jobs in the jobs component, configured in the dashboard, times in UTC |
| SSH | Root or sudo | ssh <env>@ssh.<region>.frbit.app, no root, nothing installable at runtime |
| Local MTA | No sendmail: PHP mail() fails. Use SMTP or a transactional mail provider |
fortrabbit Tooling
fortrabbit has three first-party routes besides the dashboard. Use them to look up IDs, read deployment logs and change ENV vars instead of asking the user to copy values out of the dashboard.
| Task | MCP server | frbit CLI |
|---|---|---|
| Find the app and environment of this repo | list_git_repositories, list_environments | frbit environments list --json |
| Read an environment's settings and ENV vars | get_environment | frbit environments get <env> --json |
Change ENV vars (CRAFT_*, PRIMARY_SITE_URL) | update_environment | frbit environments variables update |
| Restart after an ENV var change | – | frbit environments restart <env> |
| Deploy the latest commit again | – | frbit environments deploy <env> |
| Log of a failed build or post-deploy command | get_deployment_logs | frbit deployments logs <deployment> |
Tool names and flags change with new releases: the MCP tools describe their own arguments, and frbit <group> --help lists the current subcommands. Setup, sign-in and CI tokens: https://docs.fortrabbit.com/platform/automation.
- fortrabbit's own agent plugin bundles the MCP server with a general
fortrabbitskill for non-Craft tasks (any PHP app, SSH, troubleshooting): https://github.com/fortrabbit/agent-skills. - Never ask for a password or API token in the chat: sign-in happens in the browser, and the database password stays in the dashboard.
Common Pitfalls (Cross-Cutting)
- A deploy file without
strategy. Without the key the deployment usesreplace, also when the dashboard was set tomerge. Every local asset volume is then deleted on the next deployment unless it is inexcludePatterns. Writestrategy: mergeand the/config/projectreplace pattern into the file. Seereferences/deploy-and-environments.md. - A deploy file that drops the post-deploy commands. A key left out falls back to "no commands", not to the dashboard. Without the project config apply, schema changes stop reaching the environment. See
references/deploy-and-environments.md. - Making schema or plugin changes on the environment.
CRAFT_ALLOW_ADMIN_CHANGES=falseblocks them, and the next deployment applies the project config from git over them. Change locally, commitconfig/project, push. Seereferences/deploy-and-environments.md. - Updating Craft in the control panel.
CRAFT_ALLOW_UPDATES=falsehides updates. Runddev craft update alllocally, commitcomposer.jsonandcomposer.lock, push. - Importing the local database without the local security key. The template generates a random
CRAFT_SECURITY_KEY; data encrypted locally can't be read with it. Copy the local key into the environment's ENV vars. Seereferences/database.md. - Running the queue in web requests. Craft's default AJAX queue runner and on-demand image transforms block the PHP processes that serve the site, ending in 504s or memory kills. Run the queue in a worker job and set
CRAFT_RUN_QUEUE_AUTOMATICALLY=falseon that environment. Seereferences/limitations.md. - Expecting assets in git. Uploads stay on the environment; git deployment only goes up. Sync volumes with rsync. See
references/asset-storage.md. - Fixing code over SSH. Files changed over SSH are overwritten by the next git deployment. Fix in git.
Reference Files
Read the relevant reference file(s) for your task. Multiple files often apply.
Task examples:
- "Deploy a Craft site to fortrabbit" →
deploy-and-environments.md - "Move the deployment settings into the repo" →
deploy-and-environments.md(deploy file) - "Why did my uploads disappear after a deployment?" →
deploy-and-environments.md+asset-storage.md - "Set up staging and production" →
deploy-and-environments.md - "Which ENV vars does Craft need on fortrabbit?" →
deploy-and-environments.md - "Push the local database to fortrabbit" →
database.md - "Connect TablePlus to the fortrabbit database" →
database.md - "Sync assets between local and fortrabbit" →
asset-storage.md - "Use S3 for assets instead" →
asset-storage.md - "Set up local development for a fortrabbit project" →
local-dev.md - "Pull production content to DDEV" →
local-dev.md - "Run the Craft queue / image transforms in the background" →
limitations.md - "Why does PHP
mail()not work?" →limitations.md - "Can I install ImageMagick, wkhtmltopdf or a global npm package?" →
limitations.md
Load only the reference files your task needs.
| Reference | Scope | ~Lines |
|---|---|---|
references/deploy-and-environments.md | Where to read current values, apps and environments, the GitHub App, the Craft template, merge strategy and the /config/project replace pattern, the deploy file, ENV vars and platform variables, production settings, updates and major upgrades | ~185 |
references/database.md | MySQL per environment, credentials via platform variables, dump and import over SSH, SSH tunnel for clients, security key and table prefix, backups | ~80 |
references/asset-storage.md | Persistent storage, local volumes and .gitignore, rsync and SFTP sync, S3 volumes, exclude patterns with replace | ~90 |
references/local-dev.md | DDEV config for a fortrabbit project, ddev auth ssh, pulling the database and volumes down, multi-environment config with CRAFT_ENVIRONMENT | ~75 |
references/limitations.md | No root, jobs component (worker for the queue, crons), heavy binaries in jobs only, image transforms, mail, PDF, SSH rate limit, and the repo detection signals | ~90 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |