swarmpit / swarmpit

Lightweight mobile-friendly Docker Swarm management UI

Lightweight mobile-friendly Docker Swarm management UI

Swarmpit provides simple and easy to use interface for your Docker Swarm cluster. You can manage your stacks, services, secrets, volumes, networks etc. After linking your Docker Hub account or custom registry, private repositories can be easily deployed on Swarm. Best of all, you can share this management console securely with your whole team.

More details about future and past releases can be found in ROADMAP.md

Installation

The only dependency for Swarmpit deployment is Docker with Swarm initialized, we are supporting Docker 1.13 and newer. Linux hosts on x86 and ARM architectures are supported as well.

Package installer

Installer is your guide to setup Swarmpit platform. For more details see the installer

Stable version

Deploy our current milestone version

docker run -it --rm \
  --name swarmpit-installer \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  swarmpit/install:1.9

Edge version

Deploy latest version for the brave and true

docker run -it --rm \
  --name swarmpit-installer \
  --volume /var/run/docker.sock:/var/run/docker.sock \
  swarmpit/install:edge

Manual installation

Deploy Swarmpit by using a compose file from our git repo with branch of corresponding version.

git clone https://github.com/swarmpit/swarmpit -b master
docker stack deploy -c swarmpit/docker-compose.yml swarmpit

For ARM based cluster use custom compose file.

git clone https://github.com/swarmpit/swarmpit -b master
docker stack deploy -c swarmpit/docker-compose.arm.yml swarmpit

This stack is a composition of 4 services:

• app - Swarmpit
• agent - Swarmpit agent
• db - CouchDB (Application data)
• influxdb - InfluxDB (Cluster statistics)

Feel free to edit the stackfile to change an application port and we strongly recommend to specify following volumes:

• db-data
• influxdb-data

to shared-volume driver type of your choice. Alternatively, you can link db service to the specific node by using constraint.

Swarmpit is published on port 888 by default.

Configuration

Refer to following document

User Types

Refer to following document

Development

Swarmpit is written purely in Clojure and utilizes React on front-end. CouchDB is used to persist application data & InfluxDB for cluster statistics.

Everything about building, issue reporting and setting up development environment can be found in CONTRIBUTING.md

Demo

Deploys Swarmpit to play-with-docker sandbox. Please wait few moments till application is up and running before accessing port 888. Initialization might take a few seconds.

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

swarmpit's Issues

cannot remove user from Dockerhub

Mount -> support both bind and volumes

Misleading claims

This project describes itself as "Lightweight Docker Swarm orchestration" but in fact it's not an orchestration offering at all - it's just a UI. It is a clean UI which looks very useful but it's not orchestration - Docker Swarm and Kubernetes are examples of orchestration platforms.

I'd suggest you update the tagline to: "Lightweight Docker Swarm UI" or "Lightweight UI for Docker Swarm"

Does that make sense?

verification if new docker user exist before creating record

Remove next previous buttons in docker service create wizard

password change form

Add better BE logging - mainly in case of client error

customize user avatars

volume prune

offer prune action (deletes unused volumes) on volume list

Add service logging

restrict admin section

cannot update service - networks throw always error

readme and collaborators md

filter dockerhub users by username -> name not mandatory

login support for enter key

Data fetching on logout

Autoredeploy not supported yet, but we have field already in form

Show docker warnings in message logs if any

show volume mounts

add link to service(s) that mounts this volume

Add user actions logging

Add user password salt

Remove password info from responses

Add install page

when db is connected but not initialised offer install (admin user creation form)

0 not shown in number field if min set to 0

Add service autoredeploy

write some api test to check compatibility with docker

user can delete yourself

Add application stacks

Lets make it awesome. This is priority n.1 task after release 1.0

If service created via stack Networks section is directly under spec -> need to be mapped as well

Add restart policies

dockerhub credentials stored in local storage only

better errors from docker client

consider to not share dockerhub accounts system-wide

mby just add "shared" checkbox

show service update status and offer rollback

better history (back) support

JWT secret

Token secret -> DB hash created while init db

resource CREATE -> SAVE button

dockerhub user namespaces

let dockerhub user change his namespace

user namespaces:
https://hub.docker.com/v2/repositories/namespaces

multiple dockerhub accounts with same username can be added

GET /admin/dockerhub/users

[  
   {  
      "_id":"08537ffc00882ebc57e73f411c0021da",
      "_rev":"1-b6c1fb91983b8c65293da70db26752a5",
      "username":"lumir",
      "password":"xxx",
      "type":"dockeruser"
   },
   {  
      "_id":"08537ffc00882ebc57e73f411c0031a7",
      "_rev":"1-b6c1fb91983b8c65293da70db26752a5",
      "username":"lumir",
      "password":"xxx",
      "type":"dockeruser"
   },
   {  
      "_id":"08537ffc00882ebc57e73f411c003dbb",
      "_rev":"1-b6c1fb91983b8c65293da70db26752a5",
      "username":"lumir",
      "password":"xxx",
      "type":"dockeruser"
   }
]

also, api should never return password to frontend

when token deleted nullpointers

dependency on db in stack

compose -> swarmpit should depends on db .. otherwise install script may fail + use swarmpit as network name ..

Add placements

Show all user repositories under private section

We're now showing only private repositories under dockerhub private search section -> maybe we should rename this section to Search namespace/user and show also public repositories related to namespace/user as well.

dynamic title

every page now has "Swarmpit" title, this has to be changed according to route eg. Service "livin" - Swarmpit

missing favicon

[Documentation] Missing info about default user/password

Add async processing for docker api .. Some requests took quite long to finish mainly if mallformed

User don't want to wait usually too long to finish operation. Lets use async for such cases

Unable to fetch data from private dockerhub -> check token