Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/d1ceward/uptime_kuma_on_dokku
Dockerfile to run Uptime Kuma (monitoring) on Dokku (mini-Heroku)
https://github.com/d1ceward/uptime_kuma_on_dokku
dokku uptime-kuma
Last synced: about 2 months ago
JSON representation
Dockerfile to run Uptime Kuma (monitoring) on Dokku (mini-Heroku)
- Host: GitHub
- URL: https://github.com/d1ceward/uptime_kuma_on_dokku
- Owner: d1ceward
- License: unlicense
- Created: 2021-09-09T12:46:12.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T13:32:31.000Z (5 months ago)
- Last Synced: 2024-05-16T11:05:13.280Z (4 months ago)
- Topics: dokku, uptime-kuma
- Language: Shell
- Homepage: https://github.com/louislam/uptime-kuma
- Size: 139 KB
- Stars: 27
- Watchers: 2
- Forks: 21
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- Install-anything-on-Dokku - Uptime Kuma
README
[](https://github.com/louislam/uptime-kuma/releases/tag/1.23.13)
[](https://github.com/dokku/dokku)
[](https://github.com/louislam/uptime-kuma/graphs/commit-activity)
# Run Uptime Kuma on Dokku
## Perquisites
### What is Uptime Kuma?
[Uptime Kuma](https://github.com/louislam/uptime-kuma) is a self-hosted monitoring tool like "Uptime Robot".
### What is Dokku?
[Dokku](http://dokku.viewdocs.io/dokku) is the smallest PaaS implementation you've ever seen - _Docker
powered mini-Heroku_.
### Requirements
* A working [Dokku host](http://dokku.viewdocs.io/dokku/getting-started/installation)
# Setup
**Note:** We are going to use the domain `uptime.example.com` for demonstration purposes. Make sure to
replace it with your own domain name.
## App and plugins
### Create the app
Log onto your Dokku Host to create the Uptime Kuma app:
```bash
dokku apps:create uptime-kuma
```
## Domain
To get the routing working, we need to apply a few settings. First we set the domain.
```bash
dokku domains:set uptime-kuma uptime.example.com
```
## Persistent storage
To persists user uploads (e.g. avatars) between restarts, create a folder on the host machine and tell Dokku to mount it to the app container.
```bash
sudo mkdir -p /var/lib/dokku/data/storage/uptime-kuma
dokku storage:mount uptime-kuma /var/lib/dokku/data/storage/uptime-kuma:/app/data
```
## Push Uptime Kuma to Dokku
### Grabbing the repository
First clone this repository onto your machine.
```bash
# Via SSH
git clone [email protected]:d1ceward/uptime_kuma_on_dokku.git
# Via HTTPS
git clone https://github.com/d1ceward/uptime_kuma_on_dokku.git
```
### Set up your Dokku server as a Git remote
```bash
git remote add dokku [email protected]:uptime-kuma
```
### Push Uptime Kuma to Dokku
```bash
git push dokku master
```
## SSL certificate
Last but not least, we can go an grab the SSL certificate from [Let's
Encrypt](https://letsencrypt.org).
```bash
# Install letsencrypt plugin
dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git
# Set certificate contact email
dokku letsencrypt:set uptime-kuma email [email protected]
# Generate certificate
dokku letsencrypt:enable uptime-kuma
```
## Wrapping up
Your Uptime Kuma instance should now be available on [https://uptime.example.com](https://uptime.example.com).
### Possible issue with proxy ports mapping
If the Plausible instance is not available at the address https://plausible.example.com check the return of this command :
```bash
dokku proxy:ports plausible
```
```bash
### Valid return
-----> Port mappings for plausible
-----> scheme host port container port
http 80 5000
### Invalid return
-----> Port mappings for plausible
-----> scheme host port container port
http 5000 5000
```
If the return is not the expected one, execute this command :
```bash
dokku proxy:ports-set plausible http:80:5000
```
If the return of the command was valid and Plausible is still not available, feel free to fill an issue in the issue tracker.