Coderunner
Create, upload, deploy, and run standalone functions, jobs, schedules, and services from the Customer Portal.
Coderunner is Groundfloor's workload runtime. Each coderunner is a first-class definition (function, job, schedule, or service) with versions, deployments, and executions — managed under Build → Coderunner.
Standalone coderunners do not require an App. Creating an App with app_kind=coderunner is rejected. See Developers for CLI and MCP deploy.
Lifecycle
| Step | What happens |
|---|---|
| Create | Name, language/runtime, workload type |
| Upload | ZIP creates a new version; poll until the build completes |
| Deploy | Pin a version_id, set CPU/memory/replicas/cron/env |
| Run | Invoke functions/jobs; services expose an endpoint URL after deploy |
| Git source (optional) | Connect a repo and webhook for push-to-deploy |
Manage in the portal
Open Coderunner
Sidebar → Build → Coderunner. Select a workspace.
Create or open a workload
Create a coderunner, or open an existing one for versions, deploy, executions, and Git source.
Deploy and verify
Deploy a built version, then use Run or open the service URL. Check Process Log for runtime output.
Public URLs and domains
After a service deploys, the detail page shows the upstream/endpoint URL. Branded custom domains on the Domains tab apply to App-bound services; standalone (unbound) services use the deployment URL. Edge routing overview: Front Door.
Promote across environments
Use Environments to compare and promote coderunners (redeploy the source version onto a target sibling, creating the sibling if needed). See Environment Promotion.
Prerequisites
Control Plane must be configured with Coderunner integration (CODERUNNER_URL, CODERUNNER_TOKEN). Without them, the page shows an unavailable state.
Related API
GET/POST /v1/workspaces/{id}/coderunnersPOST …/coderunners/{id}/upload, deploy, run, git-sourceGET/POST …/coderunners/compareand…/promote- Dev token:
POST …/coderunner/dev-token(see Developers)
Full upstream shapes: Coderunner API reference.
Related
- Developers —
gf deploy, MCP, short-lived JWTs - Apps — optional product packaging
- Process Log
- Coderunner overview