{"id":26662703,"url":"https://github.com/hurlenko/aria2-ariang-docker","last_synced_at":"2026-01-26T02:17:54.322Z","repository":{"id":44915663,"uuid":"163603435","full_name":"hurlenko/aria2-ariang-docker","owner":"hurlenko","description":"🐳 Aria2 downloader and AriaNg webui Docker image based on Alpine Linux ","archived":false,"fork":false,"pushed_at":"2025-07-14T00:55:52.000Z","size":89,"stargazers_count":192,"open_issues_count":10,"forks_count":43,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-14T02:57:57.932Z","etag":null,"topics":["aria2","aria2-gui","aria2-webui","ariang","arm64","armhf","docker","docker-image","raspberrypi"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/hurlenko/aria2-ariang","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hurlenko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-12-30T17:00:25.000Z","updated_at":"2025-07-09T05:50:35.000Z","dependencies_parsed_at":"2022-08-03T13:00:15.458Z","dependency_job_id":"1d43ddee-64ad-4266-a55c-c47c718150f6","html_url":"https://github.com/hurlenko/aria2-ariang-docker","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/hurlenko/aria2-ariang-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hurlenko%2Faria2-ariang-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hurlenko%2Faria2-ariang-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hurlenko%2Faria2-ariang-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hurlenko%2Faria2-ariang-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hurlenko","download_url":"https://codeload.github.com/hurlenko/aria2-ariang-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hurlenko%2Faria2-ariang-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28764869,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T00:37:26.264Z","status":"online","status_checked_at":"2026-01-26T02:00:08.215Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aria2","aria2-gui","aria2-webui","ariang","arm64","armhf","docker","docker-image","raspberrypi"],"created_at":"2025-03-25T14:17:54.299Z","updated_at":"2026-01-26T02:17:54.304Z","avatar_url":"https://github.com/hurlenko.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mayswind/AriaNg-Native/master/assets/AriaNg.ico\" /\u003e\n\u003c/p\u003e\n\n# [Aria2](https://github.com/aria2/aria2) + [AriaNg webui](https://github.com/mayswind/AriaNg) inside a [docker container](https://hub.docker.com/r/hurlenko/aria2-ariang)\n\n[![Latest Github release](https://img.shields.io/github/release/hurlenko/aria2-ariang-docker.svg)](https://github.com/hurlenko/aria2-ariang-docker/releases/latest)\n[![Image size](https://img.shields.io/docker/image-size/hurlenko/aria2-ariang/latest)](https://hub.docker.com/r/hurlenko/aria2-ariang/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/hurlenko/aria2-ariang.svg)](https://hub.docker.com/r/hurlenko/aria2-ariang/)\n[![Docker Stars](https://img.shields.io/docker/stars/hurlenko/aria2-ariang.svg)](https://hub.docker.com/r/hurlenko/aria2-ariang/)\n\n- **[Github](https://github.com/hurlenko/aria2-ariang-docker)**\n- **[Dockerhub](https://hub.docker.com/r/hurlenko/aria2-ariang/)**\n\n## Introduction\n\nAriaNg is a modern web frontend making [aria2](https://github.com/aria2/aria2) easier to use. AriaNg is written in pure html \u0026 javascript, thus it does not need any compilers or runtime environment. You can just put AriaNg in your web server and open it in your browser. AriaNg uses responsive layout, and supports any desktop or mobile devices.\n\n## Table of Contents\n\n- [Screenshots](#screenshots)\n- [Demo website](#demo-website)\n- [Features](#features)\n- [Usage](#usage)\n  - [Docker](#docker)\n  - [docker-compose](#docker-compose)\n  - [Nginx](#running-behind-nginx-proxy)\n  - [Supported environment variables](#supported-environment-variables)\n  - [Supported volumes](#supported-volumes)\n  - [User / Group identifiers](#user-/-group-identifiers)\n- [Building](#building)\n\n## Screenshots\n\n### Desktop\n\n![AriaNg](https://raw.githubusercontent.com/mayswind/AriaNg-WebSite/master/screenshots/desktop.png)\n\n### Mobile device\n\n![AriaNg](https://raw.githubusercontent.com/mayswind/AriaNg-WebSite/master/screenshots/mobile.png)\n\n## Demo website\n\nPlease visit [http://ariang.mayswind.net/latest](http://ariang.mayswind.net/latest)\n\n## Features\n\n- Confgurable via environment variables\n- Uses the PUID and PGID evironment variables to map the container's internal user to a user on the host machine\n- Supports multiple architectures, tested on Ubuntu 18.04 (`amd64`), Rock64 🍍 (`arm64`) and Raspberry Pi 🍓 (`arm32`)\n\n## Usage\n\n### Docker\n\n```bash\ndocker run -d --name ariang -p 8080:8080 hurlenko/aria2-ariang\n```\n\nTo run as a different user and to map custom volume locations use:\n\n```bash\ndocker run -d \\\n    --name aria2-ui \\\n    -p 8080:8080 \\\n    -v /DOWNLOAD_DIR:/aria2/data \\\n    -v /CONFIG_DIR:/aria2/conf \\\n    -e PUID=1000 \\\n    -e PGID=1000 \\\n    -e ARIA2RPCPORT=443 \\\n    -e RPC_SECRET=NOBODYKNOWSME \\\n    hurlenko/aria2-ariang\n```\n\n### docker-compose\n\nMinimal `docker-compose.yml` may look like this:\n\n```yaml\nversion: \"3\"\n\nservices:\n  ariang:\n    image: hurlenko/aria2-ariang\n    ports:\n      - 443:8080\n    volumes:\n      - /DOWNLOAD_DIR:/aria2/data\n      - /CONFIG_DIR:/aria2/conf\n    environment:\n      - PUID=1000\n      - PGID=1000\n      - RPC_SECRET=secret\n      - ARIA2RPCPORT=443\n    restart: always\n```\n\nSimply run:\n\n```bash\ndocker-compose up\n```\n\n### Running behind Nginx proxy\n\nYou can use this nginx config:\n\n```nginx\nlocation / {\n    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    proxy_set_header Host $http_host;\n    proxy_set_header X-Real-IP $remote_addr;\n    # proxy_set_header X-Forwarded-Proto https;\n    proxy_pass http://127.0.0.1:5002;\n\n    # enables WS support\n    proxy_http_version 1.1;\n    proxy_set_header Upgrade $http_upgrade;\n    proxy_set_header Connection \"upgrade\";\n\n    proxy_read_timeout 999999999;\n}\n```\n\n### Supported environment variables\n\n- `PUID` - Userid who will own all downloaded files and configuration files (Default `0` which is root)\n- `PGID` - Groupid who will own all downloaded files and configuration files (Default `0` which is root)\n- `RPC_SECRET` - The Aria2 RPC secret token (Default: not set)\n- `EMBED_RPC_SECRET` - INSECURE: embeds `RPC_SECRET` into web ui js code. This allows you to skip entering the secret but everyone who has access to the webui will be able to see it. Only use this with some sort of authentication (e.g. basic auth)\n- `BASIC_AUTH_USERNAME` - username for basic auth\n- `BASIC_AUTH_PASSWORD` - password for basic auth\n- `ARIA2RPCPORT` - The port that will be used for rpc calls to aria2. Usually you want to set it to the port your website is running on. For example if your AriaNg instance is accessible on `https://ariang.mysite.com` you need to set `ARIA2RPCPORT` to `443` (default https port), otherwise AriaNg won't be able to access aria2 rpc running on the default port `8080`. You can set the port in the web ui by going to `AriaNg Settings` \u003e `Rpc` tab \u003e `Aria2 RPC Address` field, and changing the default rpc port to whatever you need, but this has to be done per browser.\n\n\u003e Note, both `BASIC_AUTH_USERNAME` and `BASIC_AUTH_PASSWORD` must be set in order to enable basic authentication.\n\n### Supported volumes\n\n- `/aria2/data` The folder of all Aria2 downloaded files\n- `/aria2/conf` The Aria2 configuration file\n\n### User / Group identifiers\n\nWhen using volumes (`-v` flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.\n\nEnsure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.\n\nIn this instance `PUID=1001` and `PGID=1001`, to find yours use `id user` as below:\n\n```bash\nid username\n    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)\n```\n\n## Building\n\n```bash\ngit clone https://github.com/hurlenko/aria2-ariang-docker\ncd aria2-ariang-docker\ndocker build -t hurlenko/aria2-ariang .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhurlenko%2Faria2-ariang-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhurlenko%2Faria2-ariang-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhurlenko%2Faria2-ariang-docker/lists"}