Installation

Requirements

Laravel Aria2 has a few requirements you should be aware of before installing:

• Composer
• PHP 8.3 or higher
• Laravel 13
• A running aria2c daemon with JSON-RPC enabled

Installation via Composer

From the root directory of your Laravel app, run the following Composer command:

composer require pullr/laravel-aria2

Laravel will auto-discover the service provider and the Aria2 facade.

Publish the configuration

You may publish the configuration file if you want to edit it:

php artisan vendor:publish --tag=aria2-config

This copies config/aria2.php into your application.

Point the client at your daemon

Add these keys to your application's .env file:

ARIA2_RPC_URL=http://127.0.0.1:6800/jsonrpc
ARIA2_RPC_SECRET=change-me

Start aria2 with RPC enabled, for example:

aria2c --enable-rpc --rpc-listen-all=false --rpc-secret=change-me

Keep the daemon on localhost and require a secret. This package sends token:<secret> on every JSON-RPC call.