Simplify Java Project Build and Deployment with Jpom: A Hands‑On Guide

Introduction

Jpom is a Java‑based lightweight online build, automatic deployment, daily operation and project monitoring tool designed to simplify CI/CD for individuals and small teams.

Pain points addressed

Developers often need to perform operations tasks without dedicated ops staff.

Different projects require different build and deployment commands.

Multiple environments (development, testing, production) need separate packaging.

Monitoring the runtime status of many projects is cumbersome.

Remote server access typically requires separate SSH and FTP tools.

Synchronizing accounts and passwords across multiple servers is inconvenient.

High‑performance automation tools are often too complex to set up.

Existing tools lack customization flexibility.

Key features

Node Management: Unified management of cluster nodes and one‑click distribution of project files.

Project Management: Create, start, stop, view real‑time console logs, and manage project files.

SSH Terminal: Browser‑based SSH with command history recording.

Online Build: Pull from Git or SVN repositories to build packages without manual uploads.

Online Scripts: Manage, schedule, and trigger scripts via webhook, with execution logs.

Docker Management: Visual management of images, containers, and Swarm clusters.

User Management: Multi‑user roles, permission control, and operation logs.

Project Monitoring: Real‑time status monitoring with automatic email and DingTalk alerts.

NGINX & SSL: Quick NGINX configuration editing and unified SSL certificate management.

Architecture overview

The overall architecture is illustrated below.

Demo access

Demo URL: https://demo.jpom.top

Username: demo

Password: jpom666

Logical nodes

Logical nodes correspond to servers. Add a node via Node Management → Logical Nodes → Quick Bind .

Repository configuration

Projects to be built must be added manually; Jpom supports pulling from Git repositories.

Build list

The build list displays all configured projects.

SSH management

Installation and usage

The official distribution provides several installation methods. The one‑click script installs Jpom to /usr/local/jpom-server by default.

# One‑click default installation + auto‑configure service on boot
curl -fsSL https://jpom.top/docs/install.sh | bash -s Server jdk+default+service

Manage the Jpom server with standard systemd commands:

Start: systemctl start jpom-server Stop: systemctl stop jpom-server Restart: systemctl restart jpom-server After a successful start, the server listens on port 2122. Access the management UI at http://127.0.0.1:2122/ (replace 127.0.0.1 with the actual server IP for remote access).

If the UI is unreachable, verify the firewall status:

# Check firewall status
systemctl status firewalld

If the firewall is active, open port 2122/tcp permanently and reload the firewall:

# Open port 2122/tcp permanently
firewall-cmd --add-port=2122/tcp --permanent
# Reload firewall to apply changes
firewall-cmd --reload

For cloud servers, also ensure the security group permits traffic on port 2122. Linux may have multiple firewall solutions (firewalld, iptables, SELinux); all should be checked.

Related links

Project repository: https://gitee.com/dromara/Jpom

Official website: https://jpom.top/