@copperlineai/paperclip-railway-sandbox-plugin

Published Railway sandbox provider plugin for Paperclip.

This package mirrors the standalone shape of the exe.dev sandbox provider: it lives in the Paperclip monorepo, but is intentionally kept outside the root workspace so operators can install it by package name from the Plugins page.

Install

From a Paperclip instance, install:

@copperlineai/paperclip-railway-sandbox-plugin

Configuration

Configure Railway from Company Settings -> Environments.

Required credentials can be supplied either in environment config or host environment variables:

• token or RAILWAY_API_TOKEN
• environmentId or RAILWAY_ENVIRONMENT_ID

Common options:

• idleTimeoutMinutes controls Railway's automatic sandbox cleanup window.
• networkIsolation defaults to ISOLATED; set PRIVATE to allow access to the Railway environment private network.
• packages installs Debian packages into a cached Railway sandbox template.
• setupScript runs as a template build step before Paperclip executes requests.
• env is baked into the sandbox at creation time for safer secret handling than per-command env.
• reuseLease keeps the sandbox alive on release; destroy still removes it.

Note: Railway Sandboxes are Debian environments exposed through the Railway SDK template builder (withPackages and run). This provider does not assume Docker is present inside the sandbox or shell out to docker run; commands execute directly in the Railway sandbox after Debian package/setup steps have completed.

Local development

cd packages/plugins/sandbox-providers/railway
bun install
bun run build
bun run test
bun run typecheck

The package depends on the public @paperclipai/plugin-sdk package so the same artifact can be installed from the Paperclip Plugins UI.