Running on Heroku
Heroku is a container-based cloud Platform as a Service (PaaS). Developers use Heroku to deploy, manage, and scale modern apps. The platform is elegant, flexible, and easy to use, offering developers the simplest path to getting their apps to market.
From the "What is Heroku?" section of their website.
Heroku provides a free hosting service which works with Umami as well as databases through add-ons. You don't need to have a database set up before this setup guide.
Setup ![Deploy](https://www.herokucdn.com/deploy/button.svg)
Automate all steps using the button above
Website
- Fork a copy of the Umami repository.
- Create an account on Heroku.
- From the dashboard page click New > Create new app.
- Choose an App name and then click Create app.
- Under Deployment method click GitHub and follow the instructions to connect Heroku to GitHub.
- Search for the repository and click Connect.
Database
- Navigate to the Resources tab and click on the Find more add-ons button.
- Search for Heroku Postgres and follow its instructions to install the add-on.
- The add-on will set the
DATABASE_URL
automatically; you should not have to manually set it. - You will need to set up the database tables by following the Create database tables section of the Install docs. You can find temporary connection details by following the Resources > Heroku Postgres > Settings > Database Credentials path. To run commands found in the docs click More > Run Console.
Build and Deploy
- With the environment variables and database set up, click the Deploy > Manual Deploy > Deploy Branch button.
- Once the build has finished, the website should be live. Follow the Open app button at the top of the dashboard to view it.
- Follow the Getting started guide starting from the Login step.