Dokploy / Dokploy/dokploy

in Built PM2 support as well as Docker for Nodejs Backend applications

Open
#4,614 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
37.4k
Forks
3k
Avg merge
1d 3h
Merged PRs (30d)
73

Description

What problem will this feature address?

Currently, Dokploy primarily relies on Docker-based deployments for Node.js applications. While Docker provides excellent isolation and portability, it introduces additional complexity and resource overhead for simple Node.js backend services that do not require containerization.

Many developers running small to medium-sized APIs, microservices, internal tools, or hobby projects prefer deploying directly with PM2. In these cases, running a full Docker container can increase memory consumption, storage usage, image build times, and deployment complexity compared to running the application directly on the host.

Adding native PM2 support would provide a lightweight deployment option for Node.js applications, allowing developers to choose between Docker-based isolation and direct process management depending on their requirements and server resources.

Describe the solution you'd like

Add native PM2 deployment support for Node.js applications alongside the existing Docker deployment workflow.

Possible implementation:

Allow users to select a deployment type: Docker or PM2.
Support deployment directly from a Git repository without requiring a Dockerfile.
Automatically install dependencies, build the application, and start it using PM2.
Provide support for PM2 ecosystem configuration files (ecosystem.config.js).
Expose PM2 logs, process status, restarts, and environment variables through the Dokploy dashboard.
Support zero-downtime reloads and automatic restarts using PM2 features.

This would give users more flexibility and make Dokploy attractive for developers who want a lightweight Node.js deployment experience without mandatory containerization.

Describe alternatives you've considered

Managing applications outside of Dokploy using PM2 manually over SSH.
Using separate deployment tools that provide native PM2 support.
Creating custom Docker images that run PM2 inside the container.

Additional context

No response

Will you send a PR to implement it?

Yes

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing Dokploy's existing Docker deployment workflow and the dashboard surfaces for deployment configuration, logs, process status, restarts, and environment variables. Done means users can choose PM2 or Docker for Node.js applications, deploy from a Git repository without a Dockerfile, use ecosystem.config.js, and access the requested PM2 controls and zero-downtime behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js, typescript
Domain
backend, devops
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.