Feature Request: Automatic Discovery of Existing Docker Compose Projects
Is your feature request related to a problem
Currently, Komodo requires manually adding each Docker Compose project (Stack). When I have existing compose projects running on a server, I have to manually create them in Komodo by specifying the project name and path. This is tedious when managing multiple servers with many existing projects.
Describe the solution you'd like
Add automatic discovery and import of existing Docker Compose projects running on connected servers.
Proposed Implementation:
Option 1: Scan on Server Connection
- When a new server is added, scan for running compose projects
- Detect compose projects by:
- Looking for running containers with
com.docker.compose.projectlabel - Scanning configured project directories for
docker-compose.ymlfiles
- Looking for running containers with
- Present a list of discovered projects with option to import
Option 2: Continuous Scanning
- Add a "Scan for Projects" button on the Stacks page
- Periodically scan for new projects (configurable interval)
- Show notification when new projects are detected
- Allow bulk import of discovered projects
Option 3: Project Directory Monitoring
- Allow configuration of "watched directories" per server (e.g.,
/opt/docker,/volume1/docker) - Automatically detect and import any compose projects in watched directories
- Similar to how Arcane and Dockhand work
Describe alternatives you've considered
- Manual project addition (current method, time-consuming)
- Writing scripts to query Docker API and add projects via Komodo API (complex workaround)
- Using other tools like Arcane or Dockhand that have auto-discovery (would prefer to use Komodo)
Use Case
Current workflow (manual):
- Deploy a compose project directly via SSH:
docker compose up -d - Switch to Komodo UI
- Click "New Stack"
- Enter project name
- Browse/enter file path
- Configure settings
- Repeat for each of 20+ projects across 3+ servers
Desired workflow (auto-discovery):
- Deploy a compose project via SSH or Komodo
- Komodo automatically detects it
- Click "Import" to add to Komodo management
- Done
Real-world scenario
I'm migrating from Portainer/Arcane to Komodo. I have:
- 15 projects on my NAS
- 8 projects on my VPS
- 10 projects on my local server
Having to manually add all 33 projects is a significant barrier to adoption.
Additional context
Most modern Docker management tools have this feature:
- Arcane: Automatically detects all compose projects in configured directories
- Dockhand: Auto-discovers existing projects
- Dockge: Scans project directory on startup
- Portainer: Can import existing stacks
This is a key quality-of-life feature that would make Komodo more competitive.
Acceptance Criteria
- Komodo can scan connected servers for existing compose projects
- Detected projects are displayed in a list with:
- Project name
- Location/path
- Current status (running/stopped)
- Number of containers
- User can select which projects to import
- Imported projects are fully manageable in Komodo
- Project files (.env, compose.yml) are accessible/editable
- Works with both local and remote servers
- Doesn't duplicate already-managed projects
Nice-to-have
- Configurable watched directories per server
- Automatic re-scan on schedule
- Notifications for newly detected projects
- Bulk import/ignore options
Source: moghtech/komodo