https://github.com/jadolg/dockerimagesave
Download Docker images as files. Useful if you are located in places where DockerHub is blocked.
https://github.com/jadolg/dockerimagesave
china cuba docker hacktoberfest iran
Last synced: 3 months ago
JSON representation
Download Docker images as files. Useful if you are located in places where DockerHub is blocked.
- Host: GitHub
- URL: https://github.com/jadolg/dockerimagesave
- Owner: jadolg
- License: mit
- Created: 2018-08-29T14:10:46.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2026-04-08T16:27:33.000Z (3 months ago)
- Last Synced: 2026-04-08T17:32:23.116Z (3 months ago)
- Topics: china, cuba, docker, hacktoberfest, iran
- Language: Go
- Homepage: https://dockerimagesave.akiel.dev/
- Size: 563 KB
- Stars: 92
- Watchers: 4
- Forks: 12
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Docker Image Save
[](https://github.com/jadolg/DockerImageSave/actions/workflows/go.yml)
## Notice on version 1.x.x
Version 1.x.x is deprecated and will not receive updates or security patches. Please upgrade to version 2.x.x.
The default service is also now running version 2.x.x which means the old client application does no longer works.
Version 2.x.x does not need any client application since it works over HTTP(s).
## Why?
Cuba is actively blocked by Docker and this makes difficult to obtain docker images since there is no direct access to
the registry, also Cuba's internet access is restricted and slow in most cases, so a way to download these images that
can be resumed is needed by thousands of developers.
## Official Docker image
Docker image is being deployed with the CI as `guamulo/dockerimagesave`
## My instance
You can use my public instance at: [https://dockerimagesave.akiel.dev](https://dockerimagesave.akiel.dev)
Metrics available in [Grafana](https://grafana.akiel.dev/d/HU5bfRRnz/dockerimagesave?orgId=2)
Uptime monitor at [Uptime](https://uptime.akiel.dev/status/dockerimagesave)
## Usage
### Server side
#### docker-compose.yml
This will spawn a dockerimagesave server with caddy as a reverse proxy with automatic https using let's encrypt.
Remember to update the domain name in the Caddyfile.
`docker compose up -d`
#### docker run (direct usage without reverse proxy)
`docker run -v $PWD/config.yaml:/config.yaml -p 8080:8080 -d guamulo/dockerimagesave`
### Client side
#### Only get the file
`wget -c --tries=5 --waitretry=3 --content-disposition "https://dockerimagesave.akiel.dev/image?name=ubuntu:25.04"`
#### Direct pipe (simple)
```bash
wget --tries=5 --waitretry=3 -q -O - "https://dockerimagesave.akiel.dev/image?name=ubuntu:25.04" | docker load
```
#### With resume support (for large images or if you want to keep the file)
```bash
wget -c --tries=5 --waitretry=3 --content-disposition "https://dockerimagesave.akiel.dev/image?name=ubuntu:25.04" && docker load -i ubuntu_25_04.tar
```
#### Selecting a specific architecture
By default the service downloads `linux/amd64`. Use the `os` and `arch` query parameters to select a different platform:
```bash
# Download linux/arm64
wget -c --tries=5 --waitretry=3 --content-disposition \
"https://dockerimagesave.akiel.dev/image?name=ubuntu:25.04&os=linux&arch=arm64"
# Download linux/arm/v7 (32-bit ARM)
wget -c --tries=5 --waitretry=3 --content-disposition \
"https://dockerimagesave.akiel.dev/image?name=ubuntu:25.04&os=linux&arch=arm&variant=v7"
```
#### Listing available platforms for an image
```bash
curl "https://dockerimagesave.akiel.dev/platforms?name=ubuntu:25.04"
```
Returns JSON like:
```json
{
"platforms": [
{"os": "linux", "architecture": "amd64"},
{"os": "linux", "architecture": "arm64"},
{"os": "linux", "architecture": "arm", "variant": "v7"}
]
}
```