peteri14/dockernexus repository overview

DockerNexus is a lightweight Docker management web application inspired by Portainer-style host administration. It provides a Go backend, Docker SDK integration, Docker Compose executable-based stack operations, and a React/TypeScript frontend for viewing and operating Docker resources from a browser.

DockerNexus is configured with environment variables.

DockerNexus can authenticate users through OAuth2 / OpenID Connect providers such as Casdoor.

⁠Docker Compose stack detection and control

STACKS_DIR is required. It must point to a directory containing one subdirectory per Compose stack. The subdirectory name is the stack name. DockerNexus also discovers active stacks from Docker resources with this label:

com.docker.compose.project

A stack is Defined when its stack directory contains compose.yml or docker-compose.yml. It is Active when at least one Docker container, network, or volume has com.docker.compose.project=<stack name>.

The Stacks page runs stack operations from the selected stack directory through the Docker Compose executable. The backend executes docker compose -f <compose file> -p <stack> up -d or docker compose -f <compose file> -p <stack> down with the stack directory as the working directory, and streams stdout/stderr back to the browser.

⁠Execute by a compose file

services:
  dockernexus:
    build: .
    ports:
      - "8080:8080"
    environment:
      ADDR: ":8080"
      DATA_DIR: "/data"
      ADMIN_USER: "admin"
      ADMIN_PASSWORD: "admin123"
      SESSION_COOKIE_NAME: "dockernexus_session"
      SESSION_TTL: "24h"
      # Set true only when serving through HTTPS.
      COOKIE_SECURE: "false"
      STACKS_DIR: "/stacks"
    volumes:
      # This is necessary for docker management
      - /var/run/docker.sock:/var/run/docker.sock
      # The SQLite database and other things may go here
      - ./data:/data
      # Mount the host directory that contains one subdirectory per Compose stack.
      - ./stacks:/stacks
    restart: unless-stopped

volumes:
  dockernexus-data: