Hosting

Running on Netlify

Deploy Umami to Netlify from a fork of the GitHub repository, using pnpm build as the build command and a remote PostgreSQL database.

Netlify provides a free hosting service which is ideal for GitHub organizations.

In this setup, you should already have a PostgreSQL database server running and accepting remote connections. If you don't already have a database, you can follow the Running on DigitalOcean guide to get a database up and running. You can also check out the Managed databases section under Hosting.

Setup#

Deploy with Netlify

Automate steps 1-5 using the button above.

  1. Fork the https://github.com/umami-software/umami project to your GitHub account.
  2. Create an account on Netlify.
  3. From the dashboard page click Import Project then specify the URL to your fork of the project on GitHub.
  4. Change the build command to pnpm build.
  5. Add the required environment variables DATABASE_URL and APP_SECRET. These values are defined in the Configure Umami step from Install.
  6. Deploy and visit your application.
  7. Follow the Quickstart guide starting from the Login step and be sure to change the default password.