PSS Uptime is an easy-to-use self-hosted monitoring tool for the Marshall Islands Public School System.
Note: This project is based on Uptime Kuma, an open-source monitoring tool created by louislam. We extend our gratitude to the Uptime Kuma project and its contributors for their excellent work.
For a live demo of the original Uptime Kuma project, visit:
Demo Server (Location: Frankfurt - Germany): https://demo.kuma.pet/start-demo
It is a temporary live demo, all data will be deleted after 10 minutes. Sponsored by Uptime Kuma Sponsors.
PSS Uptime includes all the powerful features from Uptime Kuma:
- Monitoring uptime for HTTP(s) / TCP / HTTP(s) Keyword / HTTP(s) Json Query / Websocket / Ping / DNS Record / Push / Steam Game Server / Docker Containers
- Fancy, Reactive, Fast UI/UX
- Notifications via Telegram, Discord, Gotify, Slack, Pushover, Email (SMTP), and 90+ notification services
- 20-second intervals
- Multi Languages
- Multiple status pages
- Map status pages to specific domains
- Ping chart
- Certificate info
- Proxy support
- 2FA support
git clone <your-repo-url>
cd PSS-Uptime
docker compose up -d --buildPSS Uptime is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
Warning
File Systems like NFS (Network File System) are NOT supported. Please map to a local directory or volume.
docker build -t pss-uptime -f docker/dockerfile --target release .
docker run -d --restart=always -p 3001:3001 -v pss-uptime:/app/data --name pss-uptime pss-uptimePSS Uptime is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
If you want to limit exposure to localhost only:
docker run ... -p 127.0.0.1:3001:3001 ...Requirements:
- Platform
- ✅ Major Linux distros such as Debian, Ubuntu, Fedora and ArchLinux etc.
- ✅ Windows 10 (x64), Windows Server 2012 R2 (x64) or higher
- ❌ FreeBSD / OpenBSD / NetBSD
- ❌ Replit / Heroku
- Node.js >= 20.4
- Git
- pm2 - For running PSS Uptime in the background
git clone <your-repo-url>
cd PSS-Uptime
npm run setup
# Option 1. Try it
node server/server.js
# (Recommended) Option 2. Run in the background using PM2
# Install PM2 if you don't have it:
npm install pm2 -g && pm2 install pm2-logrotate
# Start Server
pm2 start server/server.js --name pss-uptimePSS Uptime is now running on all network interfaces (e.g. http://localhost:3001 or http://your-ip:3001).
More useful PM2 Commands
# If you want to see the current console output
pm2 monit
# If you want to add it to startup
pm2 startup && pm2 saveIf you need more options or need to browse via a reverse proxy, please refer to the original Uptime Kuma documentation:
https://github.com/louislam/uptime-kuma/wiki/%F0%9F%94%A7-How-to-Install
For update instructions, please refer to the original Uptime Kuma documentation:
https://github.com/louislam/uptime-kuma/wiki/%F0%9F%86%99-How-to-Update
For the latest features and roadmap, please check the original Uptime Kuma project:
https://github.com/louislam/uptime-kuma/milestones
PSS Uptime is based on Uptime Kuma, an excellent open-source monitoring tool created by louislam and maintained by a dedicated community of contributors.
We would like to express our gratitude to:
- louislam for creating and maintaining Uptime Kuma
- All contributors to the Uptime Kuma project
- The open-source community that makes projects like this possible
If you find PSS Uptime useful, please consider supporting the original Uptime Kuma project:
Light Mode:
Status Page:
Settings Page:
Telegram Notification Sample:
PSS Uptime is a customized version of Uptime Kuma for the Marshall Islands Public School System. This project maintains all the powerful features of the original Uptime Kuma while being tailored for the specific needs of the PSS organization.
The original Uptime Kuma project was created with the following motivations:
- A need for a self-hosted monitoring tool like "Uptime Robot"
- Building a fancy, modern UI
- Learning Vue 3 and vite.js
- Showcasing Bootstrap 5 capabilities
- Using WebSocket with SPA instead of REST API
- Deploying Docker images to Docker Hub
If you love this project, please consider:
- Giving the original Uptime Kuma project a ⭐
- Supporting the Uptime Kuma project through GitHub Sponsors or Open Collective
For questions about PSS Uptime, please use the appropriate channels for this project.
For questions about the original Uptime Kuma project, please refer to:
Contributions to PSS Uptime are welcome! Please follow the project's contribution guidelines.
If you'd like to contribute to the original Uptime Kuma project (which benefits this project as well), please refer to:
- Uptime Kuma Contributing Guidelines
- Test Pull Requests
- Latest Beta Releases
- Report Bugs / Feature Requests
- Translations
This project is based on Uptime Kuma and follows the same license. Please refer to the LICENSE file for details.