Skip to content

Latest commit

 

History

History
136 lines (85 loc) · 3.88 KB

README.md

File metadata and controls

136 lines (85 loc) · 3.88 KB
Raw

Guide to Install Uptime Kuma into Oracle Linux

MIT License Donation

This guide also works for other CentOS~

⚓ Requirements

  • Oracle Cloud Infrastructure (OCI) account
  • Basic knowledge of OCI
  • Tool to connect to OCI instance (e.g. PuTTY)

🚀 Get started

  1. Create a new OCI instance

    Basic Setup

    image

    Please feel free to adjust the setup to your needs.

    Network Configuration

    The instance needs to be reachable from the internet.

    You have to create a new virtual cloud network (VCN) with a public subnet and a public IP address if you don't have one yet. Just like the following: image

    SSH Key

    You need to create a new SSH key pair or use an existing one. You can find a guide here.

    In this guide I will use the key OCI created. image Please don't forget to download the private key and save it in a safe place. You will need it later.

    Create Instance

    After checking everything, click the "Create" button and wait for the instance to be created.

    Here is my setup (Reference Only)

    image

  2. Setup Virtual Cloud Network(VCN) Security List

    Add Ingress Rules

    You need to add the following ingress rules to the security list of the VCN you created.

    Stateless Source Type Source CIDR IP Protocol Source Port Range Destination Port Range Description
    No CIDR 0.0.0.0/0 TCP All 22 Allow SSH Connections
    No CIDR 0.0.0.0/0 TCP All 3001 Uptime Kuma Default Port

    Result: image

  3. Connect to the instance

    Connect to the instance via SSH

    You can use any SSH client you like. I will use CMD in this guide.

    ssh -i <path-to-private-key> opc@<public-ip-address>

    Install Docker

    Update the instance and install Docker.

    $ sudo yum update -y

    Install Docker

    $ sudo yum install -y yum-utils

$ sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

$ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

    Start Docker

    $ sudo systemctl start docker

    Install Uptime Kuma

    Create a new directory for Uptime Kuma

    $ mkdir uptime-kuma

    Cd into the directory

    $ cd uptime-kuma

    Setup docker-compose.yml

    $ nano docker-compose.yml

    Copy and paste the https://github.com/louislam/uptime-kuma/blob/master/docker/docker-compose.yml into the file.

    Exit and save the file by pressing Ctrl + X and then Y.

    Start Uptime Kuma

    $ docker compose up -d

    The first time you start Uptime Kuma, it will take a while to download the images. After that, you can access Uptime Kuma via http://<public-ip-address>:3001.

👾 Helpful Commands

  1. Reset Uptime Kmuma Password 
    $ docker exec -it uptime-kuma npm run reset-password

📚 References

  1. Install Docker Engine on CentOS
  2. docker/docker-compose.yml
  3. Reset Uptime Kuma admin Password in Linux