Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

docker-aria2 Docker Pulls

Run aria2c from a docker container

Key features of this repository:

  • Efficiency - image is small <10MB
  • Security - process runs inside the container as regular user and so does the docker image with the USER directive
  • Management - make script allows for easy configuration and ongoing maintenance


To use this package you must ensure the following:

  • Linux host system configured with a working Docker installation
  • make installed (optional for management script)
  • git installed (optional for src and management script)

Installation - including management scripts and src

        git clone
        cd docker-aria2
        make run

Installation - standalone Docker image

docker pull hobbsau/aria2

Usage - using management scripts

Creating and running the container

$ make run

Stopping a running container

$ make stop

Starting a stopped container

$ make start

Destroying (deleting) a running or stopped container

$ make clean

Remotely trigger a container rebuild

$ make build

Usage - standalone Docker image

First let's setup the data container that will map the config directory from the host to the container as well as the output directory. This container will provide persistent storage.

$ docker create \
 --name aria2-data \
 -v <hostdir>:/config \
 -v <hostdir>:/mnt \
 hobbsau/aria2 \

Example using my host and the /srv/aria2 location on my host:

$ sudo docker create --name aria2-data -v /srv/aria2/config:/config -v /srv/aria2/mnt:/mnt hobbsau/aria2

Next we run the aria2-service and this will automatically map the volumes within the new container.

$ docker run -d \
 --restart=always \
 --volumes-from aria2-data \
 --name aria2-service \

You should see two new containers in the docker listing:

$ docker ps -a


The source repo is linked to dockerhub using autobuild. Any push to this repo will auto-update the docker image on docker hub.


aria2 aria2c docker autobuild



No releases published


No packages published