How to Host a Deno Application on Vertra Cloud

​

Requirements

• Deno 2.8+ installed locally
• Account on Vertra Cloud
• A deno.json (or deno.jsonc) at the project root

​

Project Structure

my-server-deno/
├── main.ts
├── deno.json
├── deno.lock
└── vertracloud.config

​

Configuration

​

deno.json

{
  "imports": {
    "@std/http": "jsr:@std/http@^1"
  }
}

​

vertracloud.config

MAIN=main.ts
VERSION=recommended

​

Example: HTTP Server

const port = Number(Deno.env.get("PORT") ?? 80);

Deno.serve({ hostname: "0.0.0.0", port }, (req) => {
  const { pathname } = new URL(req.url);

  if (pathname === "/health") {
    return Response.json({ status: "healthy", service: "deno-api" });
  }

  return Response.json({
    message: "Deno on Vertra Cloud",
    version: "1.0.0",
  });
});

​

Deploy

vertra deploy
vertra logs -f

​

Available Versions

​

Notes

• Dependencies: declare them in deno.json and commit deno.lock so installs are reproducible
• Permissions: the app runs with full permissions, so Deno.env, network and file access work without flags
• Environment variables: use Deno.env.get("KEY")
• Logging: use console.log() for logs that appear in real time
• Listen on 0.0.0.0 on port 80

​

Common Errors

• Entry file not found: MAIN must point to the entry file relative to the root of the zip, for example main.ts.
• Detected as another language: a Deno project with none of deno.json, deno.jsonc or deno.lock at the root is not recognized. Add one of them, or set LANGUAGE=deno in vertracloud.config.
• App starts but the site doesn’t open: the server must listen on 0.0.0.0 and port 80, not on localhost.