feat: add Minepanel template #655

Ketbome · 2026-01-16T02:18:12Z

What is this PR about?

New PR of Minepanel - Web panel for managing Minecraft servers with Docker.

Checklist

Before submitting this PR, please make sure that:

I have read the suggestions in the README.md file https://github.com/Dokploy/templates?tab=readme-ov-file#general-requirements-when-creating-a-template
I have tested the template in my instance, so the maintainers don't spend time trying to figure out what's wrong.
I have added tests that demonstrate that my correction works or that my new feature works.

Issues related (if applicable)

N/A

Screenshots or Videos

Template includes:

Backend service (NestJS API on port 8091)
Frontend service (Next.js on port 3000)
Auto-generated JWT secret and admin credentials
Docker socket access for container management
Persistent volumes for server data and database

Links:

GitHub: https://github.com/Ketbome/minepanel
Docs: https://minepanel.ketbome.lat
Docker Hub: https://hub.docker.com/r/ketbom/minepanel

github-actions · 2026-01-16T02:18:58Z

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name	Status	Preview	Last Commit
templates	✅ Ready (View Log)	Visit Preview	`9dab48f`

Copilot

Pull request overview

This PR adds a new template for Minepanel, a web-based panel for managing Minecraft servers with Docker. The template includes a backend service (NestJS API), frontend service (Next.js), auto-generated credentials, Docker socket access, and persistent storage.

Changes:

Added Minepanel template with backend and frontend services using Docker Compose
Added template configuration for domain routing, environment variables, and auto-generated secrets
Updated meta.json with Minepanel entry including metadata and tags

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 6 comments.

File	Description
meta.json	Added Minepanel entry with metadata, links, and tags between "minio" and "mixpost"
blueprints/minepanel/docker-compose.yml	Defines backend and frontend services with Docker socket access and persistent volumes
blueprints/minepanel/template.toml	Configures domain routing, environment variables, and credential generation
blueprints/minepanel/minepanel.webp	Logo for the template

Copilot · 2026-01-16T02:20:18Z

blueprints/minepanel/docker-compose.yml

@@ -0,0 +1,32 @@
+services:
+  backend:
+    image: ketbom/minepanel-backend:latest


The :latest tag violates the coding guidelines which state: 'NEVER use latest tag—it can break templates when upstream images change unexpectedly.' Pin to a specific version (e.g., ketbom/minepanel-backend:1.0.0). Before committing, verify the image exists using docker manifest inspect <image:tag>.

Copilot · 2026-01-16T02:20:18Z

blueprints/minepanel/docker-compose.yml

+      - /var/run/docker.sock:/var/run/docker.sock
+
+  frontend:
+    image: ketbom/minepanel-frontend:latest


The :latest tag violates the coding guidelines which state: 'NEVER use latest tag—it can break templates when upstream images change unexpectedly.' Pin to a specific version (e.g., ketbom/minepanel-frontend:1.0.0). Before committing, verify the image exists using docker manifest inspect <image:tag>.

Copilot · 2026-01-16T02:20:18Z

meta.json

+  {
+    "id": "minepanel",
+    "name": "Minepanel",
+    "version": "latest",


The version field should match the specific image version used in docker-compose.yml instead of latest. After pinning the Docker images to specific versions, update this field to match.

Copilot · 2026-01-16T02:20:19Z

blueprints/minepanel/template.toml

+FRONTEND_URL = "https://${frontend_domain}"
+NEXT_PUBLIC_BACKEND_URL = "https://api-${backend_domain}"


URL variables should use HTTP by default, not HTTPS. The coding guidelines state: 'URL Variables: When environment variables require URLs (e.g., WEB_URL, NEXTAUTH_URL, PUBLIC_URL), always use HTTP by default (e.g., \"http://${main_domain}\"). HTTPS should only be used if explicitly required by the application or when using a reverse proxy with SSL termination.' Change to http:// unless the application specifically requires HTTPS.

Copilot · 2026-01-16T02:20:19Z

blueprints/minepanel/docker-compose.yml

+    ports:
+      - 8091


The coding guidelines state to avoid explicit ports as Dokploy handles proxying: 'Docker Compose: Minimal—omit ports (Dokploy proxies)'. While using port numbers without host mapping is acceptable, consider whether this is necessary given Dokploy's proxy capabilities.

Copilot · 2026-01-16T02:20:19Z

blueprints/minepanel/docker-compose.yml

+    ports:
+      - 3000


The coding guidelines state to avoid explicit ports as Dokploy handles proxying: 'Docker Compose: Minimal—omit ports (Dokploy proxies)'. While using port numbers without host mapping is acceptable, consider whether this is necessary given Dokploy's proxy capabilities.

Copilot

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

Copilot · 2026-01-16T02:29:36Z

blueprints/minepanel/docker-compose.yml

+      - BASE_DIR=${BASE_DIR}
+    volumes:
+      - minepanel-servers:/app/servers
+      - minepanel-data:/app/data


Mounting the Docker socket grants the container full control over the host's Docker daemon, which is a significant security risk. While this may be necessary for Minepanel's functionality to manage Minecraft server containers, this creates a potential privilege escalation vector. Consider documenting this security implication in the template description or adding a warning comment in the docker-compose.yml file.

Suggested change

- minepanel-data:/app/data

- minepanel-data:/app/data

# WARNING: Mounting the Docker socket gives this container full control over the host's Docker daemon.

# Only use this in trusted environments and be aware this is a potential privilege escalation vector.

Copilot · 2026-01-16T02:29:36Z

blueprints/minepanel/template.toml

+[config.env]
+JWT_SECRET = "${jwt_secret}"
+CLIENT_USERNAME = "${client_username}"
+CLIENT_PASSWORD = "${client_password}"
+FRONTEND_URL = "http://${frontend_domain}"
+NEXT_PUBLIC_BACKEND_URL = "http://api-${backend_domain}"
+NEXT_PUBLIC_DEFAULT_LANGUAGE = "${default_language}"
+BASE_DIR = "/app"


The [config.env] section defines environment variables but doesn't specify which service they apply to. According to the docker-compose.yml, the backend service needs JWT_SECRET, CLIENT_USERNAME, CLIENT_PASSWORD, FRONTEND_URL, and BASE_DIR, while the frontend needs NEXT_PUBLIC_BACKEND_URL and NEXT_PUBLIC_DEFAULT_LANGUAGE. This configuration will apply all variables to all services, which works but is not explicit. Consider using the array format with service-specific variables like env = [...] in the README examples, or document that all variables are shared across services.

Suggested change

[config.env]

JWT_SECRET = "${jwt_secret}"

CLIENT_USERNAME = "${client_username}"

CLIENT_PASSWORD = "${client_password}"

FRONTEND_URL = "http://${frontend_domain}"

NEXT_PUBLIC_BACKEND_URL = "http://api-${backend_domain}"

NEXT_PUBLIC_DEFAULT_LANGUAGE = "${default_language}"

BASE_DIR = "/app"

[[config.env]]

serviceName = "backend"

env = [

"JWT_SECRET=${jwt_secret}",

"CLIENT_USERNAME=${client_username}",

"CLIENT_PASSWORD=${client_password}",

"FRONTEND_URL=http://${frontend_domain}",

"BASE_DIR=/app",

]

[[config.env]]

serviceName = "frontend"

env = [

"NEXT_PUBLIC_BACKEND_URL=http://api-${backend_domain}",

"NEXT_PUBLIC_DEFAULT_LANGUAGE=${default_language}",

]

feat: add Minepanel template

01818a0

Copilot AI review requested due to automatic review settings January 16, 2026 02:18

Copilot started reviewing on behalf of Ketbome January 16, 2026 02:18 View session

github-actions bot deployed to Preview January 16, 2026 02:18 View deployment

Copilot AI reviewed Jan 16, 2026

View reviewed changes

fix: pin images to v1.7.1 and use http for URLs

337622d

github-actions bot deployed to Preview January 16, 2026 02:25 View deployment

fix: remove explicit ports, Dokploy handles proxying

9dab48f

Copilot AI review requested due to automatic review settings January 16, 2026 02:26

Copilot started reviewing on behalf of Ketbome January 16, 2026 02:27 View session

github-actions bot deployed to Preview January 16, 2026 02:27 View deployment

Ketbome closed this Jan 16, 2026

github-actions bot deployed to Preview January 16, 2026 02:29 View deployment

Copilot AI reviewed Jan 16, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add Minepanel template #655

feat: add Minepanel template #655

Uh oh!

Ketbome commented Jan 16, 2026

Uh oh!

github-actions bot commented Jan 16, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Copilot AI Jan 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		FRONTEND_URL = "https://${frontend_domain}"
		NEXT_PUBLIC_BACKEND_URL = "https://api-${backend_domain}"

-[config.env]
-JWT_SECRET = "${jwt_secret}"
-CLIENT_USERNAME = "${client_username}"
-CLIENT_PASSWORD = "${client_password}"
-FRONTEND_URL = "http://${frontend_domain}"
-NEXT_PUBLIC_BACKEND_URL = "http://api-${backend_domain}"
-NEXT_PUBLIC_DEFAULT_LANGUAGE = "${default_language}"
-BASE_DIR = "/app"
+[[config.env]]
+serviceName = "backend"
+env = [
+  "JWT_SECRET=${jwt_secret}",
+  "CLIENT_USERNAME=${client_username}",
+  "CLIENT_PASSWORD=${client_password}",
+  "FRONTEND_URL=http://${frontend_domain}",
+  "BASE_DIR=/app",
+]
+[[config.env]]
+serviceName = "frontend"
+env = [
+  "NEXT_PUBLIC_BACKEND_URL=http://api-${backend_domain}",
+  "NEXT_PUBLIC_DEFAULT_LANGUAGE=${default_language}",
+]

feat: add Minepanel template #655

feat: add Minepanel template #655

Uh oh!

Conversation

Ketbome commented Jan 16, 2026

What is this PR about?

Checklist

Issues related (if applicable)

Screenshots or Videos

Uh oh!

github-actions bot commented Jan 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions bot commented Jan 16, 2026 •

edited

Loading