Manual Installation

Manual installation gives you full control over each component. This approach is suitable for environments where Docker is not available or when you need fine-grained configuration.

Prerequisites

Component	Requirement
Java	JDK 17 or later
Node.js	22 LTS
MySQL	8.0 or later
Redis	7.0 or later
Go	1.24 (for building the agent)

sudo apt update
sudo apt install mysql-server-8.0
sudo systemctl enable mysql
sudo systemctl start mysql
sudo mysql_secure_installation

sudo dnf install mysql-server
sudo systemctl enable mysqld
sudo systemctl start mysqld
sudo mysql_secure_installation

Create the database and user:

CREATE DATABASE easyshell CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'easyshell'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON easyshell.* TO 'easyshell'@'localhost';
FLUSH PRIVILEGES;

Install Redis

Ubuntu/Debian
CentOS/RHEL

sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl start redis-server

sudo dnf install redis
sudo systemctl enable redis
sudo systemctl start redis

Build and Run the Server

cd easyshell-server
./gradlew bootJar

Configure the server by editing application.yml or passing environment variables:

export SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/easyshell
export SPRING_DATASOURCE_USERNAME=easyshell
export SPRING_DATASOURCE_PASSWORD=your_password
export SPRING_REDIS_HOST=localhost
export SPRING_REDIS_PORT=6379

java -jar build/libs/easyshell-server-0.1.0-SNAPSHOT.jar --server.port=18080

Build and Run the Web Frontend

cd easyshell-web
npm install
npm run build
npm run preview

For production, serve the built files with Nginx. See the Production Deployment guide.

Verify Installation

Open http://localhost:18880 (Docker) or your configured URL
Login with easyshell / easyshell@changeme
Check the system status page for service connectivity