CS Monitor (CoreSaaS™ Family)

The ultimate Mobile Dashboard for Server Administration and DevOps. Powered by Flutter & Django (Rest Framework + Paramiko)

🚀 Overview

CS Monitor is a powerful boilerplate and ready-to-use application designed for Developers and SysAdmins who need to manage their servers on the go.

It consists of a Flutter Frontend (Android/iOS*) and a Django Backend. It allows you to monitor resources, manage services, view logs, run terminal commands, and even edit code directly from your phone.

Part of the CoreSaaS product family.

✨ Key Features

Security First: Biometric Login (FaceID / Fingerprint) after initial setup.
Server Management: Add unlimited servers via SSH (Paramiko). Support for Password and Private Keys.
Real-time Monitoring: RAM, Disk, and CPU usage visualization.
Service Control: Start, Stop, and Restart services. "Protected Mode" prevents accidental stops (Restart only).
Logs Viewer: Watch System Journal or File/Tail logs in real-time (50 to 500 lines).
File Explorer & Editor: Full CRUD for files/folders. Edit code/config files directly from the app.
CMD Runner: Execute predefined commands (ls -la, docker ps, git status) or run custom navigation commands.
Maintenance Mode: Toggle your server's maintenance page remotely via script execution.
Multi-language: Auto-detects En, Fr, De, It, Pt, Es.
Theming: Light / Dark / Auto mode.

🐧 Compatibility

CS Monitor works with any Linux Server running Systemd (which covers 99% of modern distros).

✅ Supported OS: Ubuntu, Debian, CentOS, AlmaLinux, Rocky Linux, Fedora, Arch, etc.
✅ Supported Services: Nginx, Apache, Caddy, Docker, MySQL, PostgreSQL, Redis, PM2, or any custom service.
❌ Not Supported: Windows Servers.

📦 For SysAdmins (Ready to Use)

If you purchased the Admin Pack, you don't need to code.

1. Backend Installation (Server)

You need to install the backend on your cloud server (VPS). * Requirement: Docker & Docker Compose. * Upload the backend_docker folder to your server. * Run: docker-compose up -d --build * Your backend is now running at http://your-server-ip:8000.

2. App Installation (Mobile)

Android: Install the provided .apk file.
iOS: (Requires building from source with a Mac, see Developer section).

3. Quick Start

Open the App.
Enter your Backend URL (e.g., http://your-server-ip:8000).
Login with the credentials provided in the backend/README.md.
Setup Biometrics.
Go to Menu > Server Admin > (+) to add your first server using SSH credentials.

💻 For Developers (Source Code)

If you purchased the Dev License, you have full access to the source code to extend this boilerplate.

Backend (Django + DRF)

Located in /backend. * Uses Paramiko for SSH connections. * Setup:

cd backend
    pip install -r requirements.txt
    python manage.py migrate
    python manage.py runserver 0.0.0.0:8000

Extending: Add new endpoints in api/views.py to expose more server metrics.

Frontend (Flutter)

Located in /frontend. * Setup:

cd frontend
    flutter pub get
    flutter run

Note on iOS: You can compile for iOS if you are using macOS. If you are on Linux/Windows, you can only build the Android APK.

🛠 Features Detail

Maintenance Mode

In Server Admin, if you enable Maintenance Mode, you must specify: 1. Folder Path: Where your script lives. 2. Script Name: The script that swaps your Nginx/Apache config to show the maintenance page.

CMD Runner

Predefined buttons include: * df -h, free -m, docker ps, whoami, git status, etc. * You can navigate folders using cd.

File Explorer

Allows you to fix bugs on the fly. You can open a .py or .php file, edit the code, save it, and restart the service immediately from the Service tab.

📄 License & Terms of Use

This software is distributed under a Single-Payment Commercial License via Gumroad. This is NOT an Open Source product.

What you CAN do: * Use the source code to create final applications for yourself or your clients. * Modify, extend, and adapt the code to suit your needs. * Deploy the backend on your own servers or third-party servers with no installation limits.

What you CANNOT do (Restrictions): * Resale Prohibited: It is strictly forbidden to resell, redistribute, sub-license, or give away the original source code (or modified versions of it) in the form of a "boilerplate," "template," "starter kit," or any competing product. * Trademark Rights: CoreSaaS™ is a trademark with a pending registration in its home jurisdiction. The purchase of this source code does not grant rights to use the "CoreSaaS" name, logos, or visual identity for your own commercial products. * Attribution: If you use this code for your own product, you must rename it and avoid using the visual identity of the CoreSaaS product family.

**Non-compliance with these terms will be treated as an infringement of intellectual property and trademark rights.**

Developed by CoreSaaS. Visit coresaaskit.com for more tools like CoreSaaS™ Accounts, CoreSaaS™ Logistic, and CS Mail.

Contents