<h1>Running on DigitalOcean</h1>
<p><a href="https://m.do.co/c/c9ebc1c0928d">DigitalOcean</a> is an affordable cloud hosting provider that will let you host
your own Umami setup. In this setup guide we are going to install
<a href="https://ubuntu.com/">Ubuntu</a>, a <a href="https://www.postgresql.org/">Postgresql</a> or <a href="https://www.mysql.com/">MySQL</a> database,
an <a href="https://www.nginx.com/">Nginx</a> webserver, <a href="https://nodejs.org/">Node.js</a> and Umami.
DigitalOcean also has a <a href="https://marketplace.digitalocean.com/apps/nodejs">NodeJS droplet build</a> that comes with Node.js, Ubuntu and Nginx which can get you started quicker. </p>
<p>For personal use, you can start with a single $5 a month cloud server
and scale up as needed. You can use this <a href="https://m.do.co/c/c9ebc1c0928d">link</a>
to get a $100 credit for the first 60 days.</p>
<p>Note, these steps can be repeated on any cloud hosting provider that offers Ubuntu.</p>
<h2>Install Ubuntu</h2>
<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu-18-04">Initial server setup with Ubuntu 18.04</a></li>
</ul>
<h2>Install database (Postgresql or MySQL)</h2>
<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-and-use-postgresql-on-ubuntu-18-04">How to install Postgresql on Ubuntu 18.04</a></li>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-mysql-on-ubuntu-18-04">How to install MySQL on Ubuntu 18.04</a></li>
</ul>
<h2>Install Nginx</h2>
<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-nginx-on-ubuntu-18-04">How to install Nginx on Ubuntu 18.04</a></li>
</ul>
<h2>Install Node.js</h2>
<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-18-04">How to install Node.js on Ubuntu 18.04</a></li>
</ul>
<h2>Install Umami</h2>
<ul>
<li>See <a href="/docs/install">Install</a> under <strong>Getting started</strong></li>
</ul>
<h2>Running Umami</h2>
<p>You can simply run <code>npm start</code> to start Umami, but it's highly recommended you use a process manager like <a href="https://pm2.keymetrics.io/">PM2</a> which will handle restarts for you.</p>
<p>To run with PM2:</p>
<pre><code>npm install pm2 -g
cd umami
pm2 start npm --name umami -- start 
pm2 save
</code></pre>
<h2>Proxying with Nginx</h2>
<p>With Umami now running, you can proxy requests to a domain or subdomain from Nginx to Umami.</p>
<p>The following config will send all requests from <code>umami.yourdomain.com</code> to your local Umami instance.</p>
<pre><code>server {
  server_name umami.yourdomain.com;

  location / {
    proxy_pass http://localhost:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}
</code></pre>
<h2>Adding an SSL certificate (optional)</h2>
<ul>
<li><a href="https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-18-04">How To Secure Nginx with Let's Encrypt on Ubuntu 18.04</a></li>
</ul>
<h2>Finish</h2>
<p>That's it! You're now self-hosting Umami on your own server.</p>


Documentation

Basics

Advanced

Guides