Install Uptime Kuma on Windows Server or Windows 10

Requirements

You can install Uptime Kuma on Windows Server and Windows 10 using both Node.js and Docker Desktop, you can choose whichever you prefer and the outcome will be the same.

• Node.js
• Git
• Docker Desktop

Downloading Uptime Kuma for Windows Server or Windows 10

Once you have reached Uptimekuma.org click on the “Download” button on the center of the page or at the top-right of the page. Alternatively, you can also visit it from here. You will only find the latest versions of Uptime Kuma.

Once you have clicked on the green “Download” button you are now landed at the page where you can get the appropriate files from.

For security reasons, always make sure you only download from official sources and check the MD5 hash value of the files.

Once the download has been completed, you need to head to the “Downloads” folder and extract the zip file. The file is named “uptime-kuma-master.zip”. You can use the Windows built-in extractor or third-party software like 7-Zip.

Install Uptime Kuma on Windows with Node.js

From the requirements section above, please make sure to Install Node.js and Git before proceeding to the next steps below.

The first step that you have to do is clone the official GitHub repo with the help of the Git command below. You can run this either in CMD or PowerShell.

git clone https://github.com/louislam/uptime-kuma.git

Now in the next step, you have to go to the directory where Uptime Kuma is located. Once you have entered the folder/directory where the files are you need to make sure all the necessary dependencies are installed.

cd uptime-kuma
npm install

Once the dependencies have been installed, you can finally start Uptime Kuma and access it.

npm start

If everything goes as planned so far (hopefully it should), Uptime Kuma will now start without any problems and the below message will display meaning you can access it in your browser locally at http://localhost:3001.

Server listening at http://localhost:3001

Install Uptime Kuma on Windows with Docker Desktop

Uptime Kuma can also be installed using Docker Desktop on Windows 10 and Windows Server.

Once you have Docker Desktop downloaded, please run through the installer screens and enable “WSL 2” during the setup process.

Once you have completed the installation instruction process, please go to the “Start Menu” and launch Docker Desktop. Please complete any outstanding configurations presented on the desktop application.

One of the first steps you have to do is pull the official Uptime Kuma Docker image, use the below command to do so in a command prompt window:

  docker pull louislam/uptime-kuma:1

As Uptime Kuma collects monitoring data logs, it has to store them somewhere. Now you have to create a folder on your PC or Server where the data will be stored. Example is:

C:\YourUserName\UptimeKuma\logs

Now to run Uptime Kuma in Docker, all you have to do is run the below command:

docker run -d --restart=always -p 3001:3001 -v C:\YourUserName\UptimeKuma\logs:/app/data louislam/uptime-kuma:1

That is it, you can now check if the Docker container is running by running the below command:

docker ps

More Features and Further Help

Uptime Kuma has a lot of information available in the FAQ and troubleshooting section. There you will find answers to all common problems with Uptime Kuma, also follow us on social media to stay updated with latest information.