On this page

Getting Started with GCSS

Welcome to the GCSS documentation. This guide will walk you through setting up your EV charging management platform from scratch.

GCSS supports OCPP 1.6 protocol and can be deployed on any Linux server. The entire installation typically takes 5-10 minutes.

System Requirements

Before installing GCSS, ensure your server meets the following minimum requirements:

ComponentMinimumRecommended
CPU2 cores4 cores
RAM4 GB8 GB
Disk Space40 GB100 GB SSD
Operating SystemCentOS 7+, Ubuntu 18.04+, Debian 10+
CPU Architecturex86_64, aarch64, armv7l
A clean OS installation is recommended for best results. GCSS installs all required dependencies automatically.

Installation Guide

Follow these steps to install GCSS on your server.

Step 1: Prepare a Linux Server

GCSS supports deployment on mainstream Linux distributions including CentOS, Ubuntu, and Debian. The following CPU architectures are supported:

Bash
ssh root@your-server-ip

Step 2: Run Installation Script

Connect to your server via SSH and run the following command to start the automated installation:

Bash
bash -c "$(curl -sS https://gcss.hk/GCSS/package/v2/start.sh)"

The script will automatically detect your system environment, install required dependencies, and configure the GCSS platform. The entire process typically takes 5-10 minutes depending on your server specs and network speed.

Make sure ports 80, 443, and 8080 are open in your firewall before running the installation.

Step 3: Access Admin Panel

Once the installation completes, the script will display the access URL for your admin panel. Open your browser and navigate to the provided URL (typically http://your-server-ip:port).

Bash
# Check Docker containers are running
docker ps

# Check GCSS service status
systemctl status gcss

Log in with the default administrator credentials shown at the end of the installation output. We strongly recommend changing the default password immediately after your first login.

First Login

After installation, access the admin panel to configure your platform.

Accessing the Admin Panel

Open your browser and navigate to your server's IP address with the admin port:

URL
http://your-server-ip:8080

Default Credentials

Use the following default credentials to log in:

FieldValue
Usernameadmin
Password123456
Important: Change the default password immediately after your first login. Go to Settings → Account → Change Password.

What's Next?

After logging in, you can:

  • Add your first charging station
  • Configure billing rates and payment gateways
  • Set up user accounts and permissions
  • Connect chargers via OCPP protocol
  • Customize branding and language settings

Dashboard Overview

The main dashboard provides real-time analytics and management controls for monitoring your charging infrastructure and operations.

Analytics Dashboard Home Page