Deploy MockServer Private Expectations

Deploy and Host MockServer Private Expectations

HTTP mock expectations with bounded logs and persistent configuration.

Validation scope: source review and static checks. This template meets the selection criterion through a public marketplace gap: no matching listing was found on September 19, 2026 using MockServer, Mock Server. Searches are bounded; private, unindexed and differently named listings may exist. The selection does not claim any competitor is broken.

About Hosting

The public gateway requires username admin and ACCESS_PASSWORD from the mockserver service. API clients can send X-Template-Key: YOUR_ACCESS_PASSWORD. Keep core and databases private. The gateway strips Basic Authorization, preserves Bearer authorization and WebSocket upgrades, and limits requests to 32 MiB. Verify native client compatibility before relying on it.

Why Deploy MockServer Private Expectations on Railway

This template wires a protected HTTPS entry point to private application services, uses generated owner credentials, and declares the persistent mounts shown above. Repository adapters and pinned image references keep the deployment configuration reviewable. Application setup and the acceptance checks below remain operator responsibilities.

Common Use Cases

Define HTTP expectations for integration tests; simulate error responses; maintain a reusable mock endpoint.

First use

Use X-Template-Key for the owner gateway and the standard MockServer HTTP API. A new volume receives an empty expectation array; existing expectations are preserved.

Recommended acceptance checks

PUT an expectation to /mockserver/expectation, invoke its path, restart and verify the expectation reloads. Test unauthorized rejection separately.

Test a volume-preserving redeploy as well as a restart. For stateful apps, take an application-consistent backup, including database/WAL and uploaded files, restore it into a separate disposable instance and verify account access and records. For configuration-as-code services, verify a clean rebuild from the saved source. Keep the original data until restoration passes.

Scope and limitations

No proxy recording or external forwarding is preconfigured. Only expectations persist, not request logs. Public access uses HTTP through the gateway; other protocol modes are outside this template.

This template has source/configuration review and static checks only. No container build, Railway startup, browser/API workflow, volume recovery or cost measurement was performed. Saved editor fidelity is not deployment proof; /healthz proves only gateway readiness. Set operator-owned provider credentials only where needed and inspect the selected upstream license before commercial use.

Dependencies for MockServer Private Expectations

Deployment Dependencies

A Railway account with capacity for the 2 services listed above, access to the selected image registries and GitHub source branch, and persistent volumes where shown are required. Keep volume-backed services at one replica. Provider accounts, SMTP and other optional integrations are supplied by the operator as described in First use and Scope and limitations.

Upstream sources

• Upstream project
• Selected source reference
• Upstream source receipt: a9db199328775afece93f68cf6988234a9e31b43.
• Images are digest-pinned in images.round8.lock.json. Rolling image tags are frozen at the captured digest, not asserted to match the source commit unless independently established.
• Adapters and the gateway use orenaksakal/railway-templates, branch codex/unique-template-drafts, with repository-root Docker build context. Keep the branch available.
• Configuration reference
• Configuration reference
• Configuration reference
• Configuration reference
• Configuration reference
• Configuration reference