{"id":13416362,"url":"https://github.com/adrianmo/powerline-docker","last_synced_at":"2026-02-12T02:13:06.319Z","repository":{"id":62577974,"uuid":"56927263","full_name":"adrianmo/powerline-docker","owner":"adrianmo","description":"A Powerline segment for showing the status of your Docker containers","archived":false,"fork":false,"pushed_at":"2017-06-30T09:11:44.000Z","size":36,"stargazers_count":60,"open_issues_count":2,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-28T05:38:43.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adrianmo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-04-23T15:47:49.000Z","updated_at":"2024-01-03T14:13:38.000Z","dependencies_parsed_at":"2022-11-03T19:27:55.125Z","dependency_job_id":null,"html_url":"https://github.com/adrianmo/powerline-docker","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrianmo%2Fpowerline-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrianmo%2Fpowerline-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrianmo%2Fpowerline-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrianmo%2Fpowerline-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adrianmo","download_url":"https://codeload.github.com/adrianmo/powerline-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243663515,"owners_count":20327300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T21:00:57.668Z","updated_at":"2026-02-12T02:13:06.282Z","avatar_url":"https://github.com/adrianmo.png","language":"Python","readme":"# Powerline Docker [![PyPI version](https://badge.fury.io/py/powerline-docker.svg)](https://badge.fury.io/py/powerline-docker)\n\nA [Powerline](https://github.com/powerline/powerline) segment for showing the status of your Docker containers.\n\nThis segment shows the number of running, paused, exited, and restarting containers together with a nice looking whale. Please feel free to propose more features and give me ideas on how to improve it.\n\n\u003cimg src=\"screenshot.png\" width=\"300\"\u003e\n\n\n## Glossary\n\n- `●`: n containers running\n- `~`: n containers paused\n- `✖`: n containers exited\n- `↻`: n containers restarting\n\n\n## Requirements\n\nThe Docker segment requires [docker](https://docs.docker.com/engine/installation/) and [docker-py](https://docker-py.readthedocs.org).\n\n\n## Installation\n\nInstalling the Docker segment can be done with `pip`:\n\n```\n$ pip install powerline-docker\n```\n\nThe Docker segment uses a couple of custom highlight groups. You'll need to define those groups in your colorscheme, for example in `.config/powerline/colorschemes/default.json`:\n\n```json\n{\n  \"groups\": {\n    \"docker\":                    { \"fg\": \"gray8\",           \"bg\": \"darkestblue\", \"attrs\": [] },\n    \"docker_running\":            { \"fg\": \"green\",           \"bg\": \"darkestblue\", \"attrs\": [] },\n    \"docker_paused\":             { \"fg\": \"brightestorange\", \"bg\": \"darkestblue\", \"attrs\": [] },\n    \"docker_exited\":             { \"fg\": \"brightred\",       \"bg\": \"darkestblue\", \"attrs\": [] },\n    \"docker_restarting\":         { \"fg\": \"gray10\",          \"bg\": \"darkestblue\", \"attrs\": [] },\n    \"docker:divider\":            { \"fg\": \"gray4\",           \"bg\": \"darkestblue\", \"attrs\": [] }\n  }\n}\n```\n\nThen you can activate the Docker segment by adding it to your segment configuration, for example in `.config/powerline/themes/shell/default.json`:\n\n```json\n{\n    \"function\": \"powerline_docker.docker\",\n    \"priority\": 30\n}\n```\n\nBy default the segment tries to connect to the Docker engine at `unix://var/run/docker.sock`, which is where it lives on most Unix systems. If your Docker engine is not living there, you can change the URL with the `base_url` argument. You can also change the `timeout` for API calls, which is set to 2 seconds by default.\n\nThe following configuration enables TLS and works with [Docker Machine](https://docs.docker.com/machine/).\n\n```json\n{\n    \"function\": \"powerline_docker.docker\",\n    \"priority\": 30,\n    \"args\": {\n      \"base_url\": \"tcp://192.168.99.100:2376\",\n      \"timeout\": 2,\n      \"use_tls\": true,\n      \"ca_cert\": \"/path/to/ca.pem\",\n      \"client_cert\": \"/path/to/cert.pem\",\n      \"client_key\": \"/path/to/key.pem\"\n    }\n}\n```\n\n\n## License\n\nLicensed under the [MIT License](LICENSE).\n\n---\n\nInspired by [powerline-gitstatus](https://github.com/jaspernbrouwer/powerline-gitstatus).\n","funding_links":[],"categories":["Container Operations","Segments","Dev Tools","Python"],"sub_categories":["User Interface"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadrianmo%2Fpowerline-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadrianmo%2Fpowerline-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadrianmo%2Fpowerline-docker/lists"}