Deploy an Actix Rust Web App


You can deploy Actix Rust web apps on Render in just a few clicks.

The app in this guide is based on the official actix_todo example and available at https://actix-todo.onrender.com.

  1. Create a new PostgreSQL database on Render and copy the internal DB URL to use below.
  2. Fork render-examples/actix_todo on GitHub.
  3. Create a new Web Service on Render, and give Render permission to access your new repo.
  4. Select Rust for the environment and use the following values during creation:

    Build Command: ./build.sh

    Here are the contents of the build script:

    #!/usr/bin/env bash
    cargo build --release
    cargo install diesel_cli --no-default-features --features postgres
    diesel database setup

    It’s simply executing commands needed to build and deploy an Actix web app on each push to your repo. It also uses the diesel CLI to run migrations before each deploy.

    Start Command: cargo run --release
    Add the following environment variable under the Advanced section:
    KeyValue
    DATABASE_URLThe internal connection string for the database you created above.

That’s it! Your web service will be live on your Render URL as soon as the build finishes.

Going forward, every push to your repo will automatically build your app and deploy it in production. If the build fails, Render will automatically stop the deploy process and the existing version of your app will keep running until the next successful deploy.

Specifying Rust toolchains

By default, Render uses the latest stable Rust toolchain, but you can specify a different toolchain by adding a file called rust-toolchain at the root of your repo. It should contain a single line specifying the version. For example:

nightly-06-01-2019

or

beta

Render will automatically install the toolchain specified in this file and use it for your app.

You can also use the RUST_TOOLCHAIN environment variable, which takes precedence over toolchain files.

If you override the toolchain in your build command with cargo +nightly ..., the specified toolchain must already be installed. You can install new toolchains using rustup as part of your build command.

Learn more about specifying a Rust toolchain.