DockerImageSave - GitLite

KO | EN

gitlite — search

#mysql #cross-platform #open-source #rust #javascript #cli #claude #go #c #editor

DockerImageSave

(★ 93)

Download Docker images as files. Useful if you are located in places where DockerHub is blocked.

File Explorer

ZIP Download

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`arch`

View Details ▼

This command is an alias of `uname --machine`.

tldr uname

View documentation for the original command:

arch

Display the system's architecture:

arch -x86_64 {{command}} {{argument1 argument2 ...}}

Run a command using x86_64:

🔍

`docker compose up`

View Details ▼

Start and run Docker services defined in a Compose file.

docker compose up

Start all services defined in the docker-compose file:

docker compose up {{[-d|--detach]}}

Start services in the background (detached mode):

docker compose up --build

Start services and rebuild images before starting:

🔍

`docker run`

View Details ▼

This command is an alias of `docker container run`.

tldr docker container run

View documentation for the original command:

# Project Badges

logo
Go Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## 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"}
  ]
}
```