Support

How do I set up aria2 on my server?

Install aria2 and start it with RPC enabled:

aria2c --enable-rpc --rpc-listen-port=8080 --rpc-secret=YOUR_TOKEN

Use the hostname/IP of your server, the port you chose, and the token in Ariane's settings.

The app says "Connection lost"

This means Ariane cannot reach your aria2 server. Check that:

• Your phone is on the same network as the server (or has a route to it)
• aria2 is running with --enable-rpc
• The hostname, port, and HTTPS setting in Ariane match your server
• No firewall is blocking the port

iOS asks for local network permission

Ariane needs local network access to communicate with your aria2 server. When prompted, tap "Allow". If you denied it, go to Settings → Ariane → Local Network and enable it.

Connection fails with self-signed certificates

Ariane supports self-signed HTTPS certificates for local servers (like Synology NAS). If you're having trouble, try disabling HTTPS in Ariane's settings and using HTTP instead.

Do I need a token?

The token is optional. If your aria2 server is started with --rpc-secret, enter that token in Ariane. If not, leave it blank.

How do background notifications work?

When the app is in the background, iOS periodically wakes it to check your server. If downloads completed while you were away, you'll get a notification. The timing is controlled by iOS to preserve battery.