Skip to content

Developer tools

PHP Runner

php-runner is a container runtime for deploying PHP applications on Eyevinn Open Source Cloud as “My Apps”. It clones your Git repository (public or private), optionally targets a branch and subdirectory for monorepos, installs dependencies with Composer when a composer.json is present, and serves your app on Apache with mod_php (PHP 8.3). It also auto-detects common PHP framework docroots (like public/index.php) or lets you pin the entry directory explicitly, with .htaccess and mod_rewrite enabled so typical framework routing works out of the box. As a managed OSC service, php-runner removes the work of packaging and operating your own runtime: you provide the repo URL and it provisions, builds, and starts the app for you, including a build-time loading server that reports health while dependencies are installing and signals failures if the build breaks. When you need extra setup beyond Composer, you can include a setup.sh that runs before Apache starts, without maintaining a custom base image. php-runner also plugs into OSC-native capabilities: token-based authentication, build status signaling, and optional config service support to load runtime environment variables at startup (including secrets managed through OSC), so you can keep configuration out of container env vars and wire it into the rest of your OSC workflow.

Deploy PHP Runner on Open Source Cloud

  1. Web console: press Launch above, sign in, name the instance and create it.
  2. Command line: with your personal access token in OSC_ACCESS_TOKEN, run npx -y @osaas/cli@latest create eyevinn-php-runner myinstance. Add -o Key=Value for any required settings.
  3. Your AI agent: connect it to the OSC MCP server at https://mcp.osaas.io/mcp and ask: “Create an instance of PHP Runner on Open Source Cloud and give me its URL.” How to connect

What it costs

One running PHP Runner instance uses 10 tokens a day. The free Basic plan's 100 one-time tokens run it for about 10 days. On Personal (40 tokens a day) one instance runs continuously.

See plans and token allowances

Open source, no lock-in

PHP Runner is built from the open source project at github.com/Eyevinn/php-runner. You can run the same project on your own infrastructure or another cloud whenever you want, and take your data with you.

Questions about PHP Runner

How much does PHP Runner cost on Open Source Cloud?

One running PHP Runner instance uses 10 tokens a day. The free Basic plan's 100 one-time tokens run it for about 10 days. On Personal (40 tokens a day) one instance runs continuously. Prices and allowances are on https://www.osaas.io/pricing.

How do I deploy PHP Runner?

Three ways: press Launch to create it in the web console; run npx -y @osaas/cli@latest create eyevinn-php-runner myinstance with OSC_ACCESS_TOKEN set (add -o Key=Value for any required settings); or connect your AI agent to the OSC MCP server at https://mcp.osaas.io/mcp and ask it to "Create an instance of PHP Runner on Open Source Cloud and give me its URL."

Can I move PHP Runner off Open Source Cloud later?

Yes. PHP Runner is open source, built from https://github.com/Eyevinn/php-runner, so you can run the same project on your own infrastructure or another cloud and take your data with you.