Skip to content

Ali7Zeynalli/S-RCS

Repository files navigation

S-RCS (Server Reporting and Controlling System)

GitHub stars License Docker Platform Repo Size Website

S-RCS Cover

๐ŸŒŸ Introduction

S-RCS is a comprehensive web-based portal designed to revolutionize Windows Active Directory management. By moving administration from the traditional interface to a streamlined web platform, S-RCS significantly reduces time loss and enhances operational efficiency.

๐ŸŒ Visit the Official Website & Documentation: Ali7Zeynalli.github.io/SRCS

The system is built on a core philosophy of speed and simplicity: virtually every administrative taskโ€”from creating Users, Groups, and Organizational Units (OUs) to managing complex assignmentsโ€”can be completed in just 3 clicks.

๐ŸŽฏ Key Objectives

  • Minimize Time Loss: Streamlined workflows replace complex navigation.
  • "3-Click" Efficiency: Optimized UX design ensures rapid execution of tasks.
  • Centralized Management: Handle User creation, Group management, OU structuring, and movements from a single dashboard.

๐Ÿ†• What's New in v1.3.0

๐ŸŽซ Task Management (Helpdesk) - Full IT ticketing system with AD integration, audit logging, and status workflows. See Changelog

๐Ÿš€ Key Features

  • ๐ŸŒ Multi-language Support: The platform is fully multilingual, allowing administrators to work in their preferred language for better accessibility and ease of use.
  • โšก Rapid Deployment: Leverages Docker technology to get the entire system up and running in under 2 minutes.
  • ๐Ÿ›ก๏ธ Secure & Robust: Built with security best practices, ensuring safe handling of AD credentials and providing detailed activity logging.

๐Ÿ“ฆ Installation & Setup

๐Ÿ“˜ Complete Installation Guide

For a detailed, step-by-step installation guide (including Docker, AD setup, and screenshots), please see: ๐Ÿ‘‰ INSTALL_EN.md

Get S-RCS running securely in your environment with a few simple commands.

1. Prerequisites

  • Docker & Docker Compose installed on your server.
  • Network access to your Active Directory Domain Controller.
  • Active Directory Configuration:
    • ๐Ÿ”ฅ Firewall: Ensure Port 636 (LDAPS) is OPEN on the Domain Controller.
    • ๐Ÿ” Certificates: The Active Directory Certificate Services role must be active.
    • ๐Ÿ› ๏ธ Required Roles: You must install:
      • Certification Authority
      • Certification Authority Web Enrollment
    • Note: Without these, the secure LDAPS connection will fail.

2. Environment Configuration

Before deployment, configure your environment by editing the .env file in the project root:

# MySQL Database Settings
MYSQL_ROOT_PASSWORD=YourSecureRootPassword
MYSQL_DATABASE=ldap_auth
MYSQL_USER=srcs_admin
MYSQL_PASSWORD=YourSecurePassword

# MySQL Port
MYSQL_PORT=3306

# Web Server Ports
HTTP_PORT=8080
HTTPS_PORT=8043

# phpMyAdmin Port
PMA_PORT=8081

Important

Security Notice: Change the default passwords before deployment!

  • MYSQL_ROOT_PASSWORD - MySQL root user password
  • MYSQL_PASSWORD - Application database password
  • These credentials will be used during the installation wizard

3. Deployment

Clone the repository and start the containers:

# Clone the repository
git clone https://github.com/Ali7Zeynalli/S-RCS.git
cd S-RCS

# Edit environment file (REQUIRED)
# nano .env  OR  notepad .env

# Build and start containers
docker-compose up -d --build

The system will initialize typically within 2 minutes.

4. Access Points

After deployment, access the system via:

Service URL Description
S-RCS https://localhost:8043 Main application (HTTPS)
S-RCS http://localhost:8080 Main application (HTTP)
phpMyAdmin http://localhost:8081 Database management

Note

Replace localhost with your server IP for remote access.

5. Visual Installation Wizard

Once the containers are running, navigate to https://localhost:8043 (or your configured port). The comprehensive installation wizard will guide you through the setup process:

1. System Requirements 2. Server Information
System Requirements Server Information
Validates server environment Domain & Server Details
3. Database 4. Confirmation
Database Confirmation
Database Connection Review Settings
5. Installation Successful 6. System Locked
Success System Locked
Setup Complete ๐Ÿ”’ System locks automatically

๐Ÿ” Login & Dashboard

7. Secure Login

Access the system securely using your credentials. The login screen is designed for quick and safe authentication.

Login Screen

8. Interactive Dashboard

Upon login, you are greeted with a comprehensive dashboard providing real-time statistics and quick access to all modules.

System Dashboard

๐Ÿ‘ฅ User Management

S-RCS provides a powerful and intuitive interface for complete user lifecycle management, allowing you to perform complex tasks in seconds.

Comprehensive Control

Manage every aspect of user accounts with ease:

  • Create & Edit: Quickly onboard new users or update existing profiles with a user-friendly form.
  • Detailed Views: Access comprehensive user information, including attributes, contact info, and group memberships.
  • Group Assignment: Easily add or remove users from Security and Distribution groups without navigating deep menus.
  • OU Management: Clear visualization of organization structure and simple movement of users between Organizational Units.

User Management Interface

Security & Lifecycle Actions

Perform critical security actions directly from the dashboard:

  • Password Management: Reset passwords and force secure password changes on next login.
  • Account Status: Instantly Lock/Unlock or Activate/Deactivate accounts to maintain security.
  • Deletion: Safely remove user accounts when needed.
User Details Action Menu
User Details View Actions Menu
View full profile Quick administrative actions

๐Ÿข Organizational Unit (OU) Management

Efficiently structure your Active Directory environment with comprehensive OU management tools.

Complete OU Lifecycle

  • Create OUs: Rapidly provision new Organizational Units to structure your users and resources.
  • Detailed Insights: View comprehensive details of any OU, including all contained Users, Groups, and Computers.
  • Edit & Move: Rename OUs or restructure your hierarchy by moving OUs to different parents with simple actions.
Create & Manage Detailed Contents
OU Creation OU Details
Create new OUs instantly Explore users & groups within
Hierarchy Management Advanced Actions
OU Structure OU Actions
Visualize tree structure Edit, Move, or Delete

๐Ÿ‘ฅ Group Management

Simplify the complexity of permission and access management with robust Group tools.

Group Administration

  • Create Groups: Easily create Security and Distribution groups with specific scopes.
  • Member Management: Add or remove users from groups instantly. Search for users and add them in bulk.
  • Details & Insights: View full group details, including member lists, descriptions, and parent OUs.
  • Move & Edit: Seamlessly move groups between OUs or modify their properties.

Group Management

Member Assignment

Visual interface for managing group composition:

  • Add Members: Intuitive search-and-add functionality.
  • Remove Members: Quick removal of users from the group list.
Group Details Add/Remove Members
Group Details Group Members
View composition Manage access rights

๐Ÿ’ป Computer Management

Monitor and organize your domain-joined resources effectively.

Device Administration

  • Inventory Views: Access a complete list of computers joined to the domain.
  • Object Management: View detailed attributes of computer objects.
  • OU Movements: Easily move computers between Organizational Units to apply different Group Policies.
Computer List Computer Details
Computer Inventory Computer Move
List of all domain computers View details & move objects

๐Ÿ“œ Group Policy (GPO) Management

Gain visibility into your Group Policy Objects to ensure compliance and security configuration.

Policy Insights

  • GPO Inventory: View a complete list of all Group Policy Objects in your environment.
  • Detailed Analysis: Inspect the specific settings, scopes, and linked OUs for each GPO.
  • Status Monitoring: Quickly identify disabled or unlinked policies.
GPO List GPO Details
GPO List GPO Settings
Inventory of all policies Deep dive into policy settings

๐ŸŽซ Task Management (Helpdesk)

A fully integrated IT helpdesk and ticketing system to track, manage, and resolve internal support requests.

Ticket Lifecycle

  • Create Tickets: Quickly log new support requests with subject, category, priority, and affected user.
  • Assign & Track: Assign tickets to administrators and track progress through status updates.
  • Edit & Delete: Modify ticket details or remove completed/invalid tickets with full audit trail.
  • Comments & Notes: Add public replies or internal notes for team collaboration.

Task Management Dashboard

Key Features

  • Affected User Integration: Link tickets directly to AD users for quick context and actions.
  • Category Management: Organize tickets by customizable categories (Hardware, Software, Network, etc.).
  • Status Workflow: Track tickets through New โ†’ Assigned โ†’ In Progress โ†’ Resolved โ†’ Closed.
  • Full Audit Logging: Every action (create, edit, delete, assign, comment) is logged to Activity Logs.
Create Ticket Ticket Details
Create New Ticket Ticket Details
Log new support requests View history & manage actions

๐Ÿ“Š Reporting & Analytics

Turn data into actionable insights with powerful one-click reporting.

One-Click Exports

Generate detailed reports for any resource type in seconds. Ideal for auditing, compliance, and inventory management.

  • Supported Resources: Users, Groups, Computers, Organizational Units (OUs), and GPOs.
  • Flexible Formats: Export data immediately to Excel (.xlsx) or CSV formats.
  • Efficiency: No complex queries neededโ€”just click and download.

Reporting Interface

๐Ÿ“ Audit Logging

Maintain complete transparency and accountability across your organization with the integrated audit system.

Activity Tracking

Every modification and administrative action within the portal is meticulously recorded.

  • Who: Identifies the administrator responsible for the action.
  • What: Details the specific operation performed (e.g., "User Created", "Group Modified").
  • When: Precise timestamping for every event.
  • Details: Captures relevant context and success/failure status.

Audit Logs

โš™๏ธ System Configuration

Complete control over the platform's behavior and settings from a centralized administration hub.

Central Administration

Manage all system-wide configurations, including:

  • General Settings: Application defaults and preferences.
  • AD Configuration: Domain controller connections and base DN settings.
  • Security Policies: Password rules and access controls.
  • Customization: Interface options and language settings.
Admin Panel General Settings
Configuration Overview Main Settings
Central control panel Core system configuration
Advanced Options Environment Setup Security
Advance Config Environment Security
Detailed system tuning Environment parameters Security & Access

๐ŸŒ Remote Access Solution

๐Ÿ’ก Need to manage S-RCS from anywhere?

Use NovusGate โ€” our self-hosted VPN solution built on WireGuardยฎ to securely access S-RCS from home, travel, or remote offices without static IP or port forwarding.

๐Ÿ‘‰ View Remote Access Guide


๐Ÿค Professional Support / Enterprise Support

Finding installation difficult? We can help!

If you cannot perform the steps shown in this guide yourself or need full enterprise-level support, you can contact us:

Paid Services

Service Description
๐Ÿ› ๏ธ Full Installation Complete installation of S-RCS in your infrastructure
๐Ÿ”ง AD Configuration Certificate Services, LDAPS, Firewall configuration
๐Ÿ“ž Technical Support Problem resolution and ongoing support
๐Ÿ“š Training S-RCS usage training for your team

๐Ÿ’ฐ Pricing: Service fees are calculated individually based on the scope and complexity of work. Contact us for a free consultation.

Contact

๐Ÿ“ง Email: Ali.Z.Zeynalli@gmail.com
๐Ÿ’ผ LinkedIn: linkedin.com/in/ali7zeynalli
๐Ÿ“ฑ Phone: +49 152 2209 4631 (WhatsApp)

๐Ÿ’ผ SLA (Service Level Agreement) support is available for enterprise customers.

๐ŸŒ Supported Languages

Language Dil
๐Ÿ‡ฆ๐Ÿ‡ฟ Azerbaijani Azษ™rbaycan
๐Ÿ‡ฌ๐Ÿ‡ง English ฤฐngilis
๐Ÿ‡ฉ๐Ÿ‡ช German Alman
๐Ÿ‡ท๐Ÿ‡บ Russian Rus
๐Ÿ‡น๐Ÿ‡ท Turkish Tรผrk

๐Ÿ“„ License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

ยฉ 2025 Ali Zeynalli

The Apache 2.0 License allows you to:

  • โœ… Use the software for any purpose (including commercial)
  • โœ… Modify and distribute the software
  • โœ… Use patent claims of contributors

While requiring you to:

  • ๐Ÿ“‹ Include the original copyright notice
  • ๐Ÿ“‹ Include the LICENSE and NOTICE files
  • ๐Ÿ“‹ State significant changes made to the software
  • ๐Ÿ“‹ Provide attribution to the original author

๐Ÿ“œ See NOTICE file for attribution requirements.

About

Server Reporting and Controlling System

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages