Logo / Docs

Render

You can run FusionAuth on most cloud providers, including Render, a platform for deploying containerized applications.

Prerequisites#

To complete this guide, you will need:

  • A Render account: for this tutorial, you can use the free version, but a production deployment requires a paid account. Performance on the free tier will be much slower than on a paid account.

Fork the render blueprint#

Render provides the ability to set up projects with blueprints, a form of Infrastructure as Code (IaC) based on a YAML file. The FusionAuth blueprint includes a PostgreSQL database and a FusionAuth Web service.

While you can run a blueprint directly from our repository, it’s a best practice to run this blueprint from a forked version of the repository in your own GitHub account. Since blueprints automatically update when the repository changes, you must own your blueprint repository to maintain full control over your instance.

To create your own fork based on the FusionAuth blueprint:

  1. Visit the FusionAuth/fusionauth-render-blueprint repository.
  2. Click the Fork button in the upper right.
  3. Use the default values and click Create fork to create your fork.
  4. Wait a few seconds for GitHub to create your fork.
  5. Once your browser loads a new repository with the subtitle “forked from FusionAuth/fusionauth-render-blueprint”, you’re ready to configure your instance.

Create a new blueprint#

  1. On your Render account dashboard, click the Blueprints link in the navigation.

  2. Click New Blueprint Instance.

  3. Connect your repository using the URL, which should look something like: https://github.com/<your-github-username>/fusionauth-render-blueprint.

  4. Set up your project with the following configuration:

    • name: FusionAuth
    • branch: main
    • blueprint path: blank (this blueprint uses the default setup)
    • if prompted to use existing services, select Create all as new services

  5. Click Deploy Blueprint. This may take some time, but remember that free tier deploys shut down after 15 minutes of idle time. Stay close so you can use your new instance before it automatically shuts down.

After setting up the database and FusionAuth instance, Render will create the following variables for your FusionAuth instance:

  • DATABASE_HOST: the public URL for your database.
  • POSTGRES_PASSWORD: the database password that FusionAuth uses to connect to your database.
  • POSTGRES_USER: the database username that FusionAuth uses to connect to your database.
  • FUSIONAUTH_APP_RUNTIME_MODE: sets your FusionAuth instance to Production mode.

Set Up FusionAuth#

Now you need to configure FusionAuth:

  1. In the Render account dashboard, open the Resources section of your blueprint. Click the URL to open the FusionAuth Admin UI.

  2. Before you can access the FusionAuth Admin UI, you must finish the FusionAuth setup wizard by creating an admin user:

    • Enter an email address, name, and password.
    • Select an option from the How did you hear about us dropdown.
    • Mark the checkbox labelled I accept the terms of the license agreement.

    Click Continue setup to create an admin user using these credentials.

  3. Congratulations! You now have a working instance of FusionAuth.

Conclusion and Next Steps#

To make use of your new FusionAuth instance, consider the following next steps: