2 minute read

We have already developed a REST API using Deno on Linux, protected it with the JWT authentication, and connected it to the MongoDb Atlas. To complete this story, we need to configure our deployment process and deploy the app to the cloud. So this is what this video is about, let’s get started.

Task description

  • Deploy a deno app
  • Deploy on push to the main branch
  • Run unit tests
  • Run lint



  • Create a repository (if you hadn’t created it so far)
  • Upload the source code to the repository


Create an app


Next, we need to create a Procfile. Procfile is a mechanism for declaring what commands are run by your application’s dynos on the Heroku platform.

  • Add a Procfile to the project with the following content:
web: deno run --allow-net --allow-env --allow-read mod.ts --port=${PORT}
  • Pay attention to permission flags. -A may not be the best choice. Don’t grant more permissions than the app actually needs

GitHub (Continue)

  • Setup the GitHub Actions (pipeline)
  • Setup a new workflow
  • Use the following yaml template:
name: Deno

    branches: [main]
    branches: [main]

    runs-on: $ # runs a test on Ubuntu, Windows and macOS

        deno: ["v1.x", "nightly"]
        os: [macOS-latest, windows-latest, ubuntu-latest]

      - name: Setup repo
        uses: actions/checkout@v2

      - name: Setup Deno
        uses: denolib/setup-deno@v2
          deno-version: $ # tests across multiple Deno versions

      - name: Cache Dependencies
        run: deno cache deps.ts

      - name: Lint
        run: deno lint --unstable

      - name: Unit tests
        run: deno test --allow-env --allow-read
  • Run
  • Review the output

Heroku (continue)

  • Test the app

The Heroku platform passes a port for the application via the arguments. If the source code doesn’t have this logic, then add it to the mod.ts:

const DEFAULT_PORT = 8000;
const argPort = parse(Deno.args).port;
await app.listen({ port: argPort ?? DEFAULT_PORT });

The parse function can be imported from the https://deno.land/std/flags/mod.ts.

  • Push the source code
  • View the running logs
  • Add the Config Vars at the Settings tab (if necessary)


Now we have the configured deployment process, with lint and unit tests. The application deploys automatically, runs in the cloud, and connects to the MongoDb Atlas. Let me know if you have any questions in the comments below, I hope you enjoyed this video, and I’ll see you next time.