https://github.com/tetra-fox/container-info
🐋 A tiny Golang API that returns metadata of all Docker containers.
https://github.com/tetra-fox/container-info
api container containers docker docker-compose go golang metadata microservice microservices status
Last synced: 2 months ago
JSON representation
🐋 A tiny Golang API that returns metadata of all Docker containers.
- Host: GitHub
- URL: https://github.com/tetra-fox/container-info
- Owner: tetra-fox
- License: gpl-3.0
- Created: 2022-05-17T19:03:25.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-12-15T05:40:49.000Z (4 months ago)
- Last Synced: 2025-12-18T01:52:23.722Z (3 months ago)
- Topics: api, container, containers, docker, docker-compose, go, golang, metadata, microservice, microservices, status
- Language: Go
- Homepage:
- Size: 299 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# container-info 
A tiny Golang API that returns metadata of all Docker containers.
I created this because I wanted a simple way to get the status of the various services that run my home network without returning sensitive information (such as my network configuration, volume bindings or entrypoint arguments).
You can see a live instance of this [here](https://home.tetra.cool/api), and in use [here](https://home.tetra.cool)!
### docker-compose example
```yaml
services:
container-info:
image: "ghcr.io/tetra-fox/container-info:latest"
ports:
- "3621:8080"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro # So we can get information from Docker!
```
### Endpoints
| Method | Endpoint | Description |
| ------ | -------------- | --------------------------------------------------------------------- |
| GET | / | Returns the metadata of all containers. |
| GET | /{name(s)} | Returns the metadata of the specified container(s). (comma-separated) |