README

Best and hottest interface to interact with aria2

If you like / use this project, please let me known by adding a ★ on the GitHub repository.

Usage

docker run --interactive --publish 80:80 --rm --tty timonier/webui-aria2

Note: By default nginx opens port 80.

It is possible to change UID and / or GID of user nginx (user used to run nginx) with environment variables NGINX_UID and NGINX_GID:

docker run --env NGINX_GID=1005 --env NGINX_UID=1005 --interactive --publish 80:80 --rm --tty timonier/webui-aria2

It is possible to run a container in read-only mode if you mount the following folders:

• /etc if you want to change UID or GID of user nginx.
• /run, /tmp and /var/cache/nginx.

Note: /run, /tmp and /var/cache/nginx can be mount as tmpfs. In that case, /run must have flag exec.

# If you do not want to change "UID" or "GID" of user "nginx"

docker run --interactive --publish 80:80 --read-only --rm --tmpfs /run:exec --tmpfs /tmpfs --tmpfs /var/cache/nginx --tty timonier/webui-aria2

# If you want to change "UID" or "GID" of user "nginx"

docker run --env NGINX_GID=1005 --env NGINX_UID=1005 --interactive --publish 80:80 --read-only --rm --tmpfs /run:exec --tmpfs /tmp --tmpfs /var/cache/nginx --tty --volume /etc timonier/webui-aria2

This image can be used with timonier/aria2. An example of usage is provided with docker-compose:

# Prepare the project

export RPC_SECRET=0fd9094d-76ca-4a76-be82-eaf513a1ccd2

# Start the project

docker-compose up -d

# Go to "http://localhost/"

Note: Don't forget to change the token used between aria2 and webui-aria2. Use bin/generate-secret if you want to generate a strong token.

Links

• command "docker run"
• docker-compose
• image "timonier/aria2"
• image "timonier/webui-aria2"
• timonier/webui-aria2
• ziahamza/webui-aria2