# Swarmpit Docker
Link: [https://github.com/swarmpit/swarmpit#installation](https://github.com/swarmpit/swarmpit#installation) [https://swarmpit.io/](https://swarmpit.io/)
[](https://swarmpit.io/)
Lightweight mobile-friendly Docker Swarm management UI
⚠️ **Status:** This UI is in maintenance mode. Click [here](https://github.com/swarmpit/swarmpit/issues/719) for details.
[](https://github.com/swarmpit/swarmpit/releases) [](https://gitter.im/swarmpit_io/swarmpit) [](https://github.com/swarmpit/swarmpit/actions/workflows/build.yml) [](https://github.com/swarmpit/swarmpit/pulls) [](https://opencollective.com/swarmpit)
[](https://twitter.com/swarmpit_io)
[](https://raw.githubusercontent.com/swarmpit/swarmpit/master/resources/public/imac.png)
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.
Swarmpit doesn't compromise your privacy as it is completely self-hosted and will never gather any metrics or other data from you.
More details about future and past releases can be found in [ROADMAP.md](https://github.com/swarmpit/swarmpit/blob/master/ROADMAP.md)
[](https://opencollective.com/swarmpit)
## 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
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
```
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](https://github.com/swarmpit/swarmpit/blob/master/docker-compose.yml) is a composition of 4 services:
- app - Swarmpit
- [agent](https://github.com/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](https://docs.docker.com/compose/compose-file/#placement).
Swarmpit is published on port `888` by default.
## Environment Variables
By default Swarmpit offers you to configure first user using web interface. If you want to automate this process, you can use docker config to provide users.yaml file.
Refer to following [document](https://github.com/swarmpit/swarmpit/blob/master/doc/USER_CONFIG.md) for details.
## User Types
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](https://github.com/swarmpit/swarmpit/blob/master/CONTRIBUTING.md)
## Demo
[](https://github.com/swarmpit/swarmpit#demo)
[](http://play-with-docker.com/?stack=https://raw.githubusercontent.com/swarmpit/swarmpit/master/docker-compose.yml)
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.