Skip to content

Advanced Configuration

Christian Blank edited this page Nov 8, 2024 · 1 revision

Advanced Configuration Guide

Extended Configuration Options

Telegram Section

[telegram]
token = YOUR_BOT_TOKEN
admin = YOUR_TELEGRAM_USER_ID
additional_admins = 123456789,987654321
# Enable or disable inline keyboard buttons
use_inline_keyboard = true
# Custom messages
welcome_message = Welcome to Addarr!
# Notification settings
notify_on_add = true
notify_on_grab = true
notify_on_import = true

Sonarr Advanced Settings

[sonarr]
enabled = true
host = http://localhost:8989
apikey = YOUR_SONARR_API_KEY
quality_profile = HD-1080p
language_profile = English
root_folder = /path/to/tv/shows
# Advanced options
season_folders = true
monitored = true
search_on_add = true
# Series type (anime, standard, daily)
series_type = standard
# Tags (comma-separated)
tags = addarr,automated

Radarr Advanced Settings

[radarr]
enabled = true
host = http://localhost:7878
apikey = YOUR_RADARR_API_KEY
quality_profile = HD-1080p
root_folder = /path/to/movies
# Advanced options
minimum_availability = announced
search_on_add = true
monitored = true
# Tags (comma-separated)
tags = addarr,automated

Logging Configuration

[logging]
debug = false
log_level = INFO
log_file = /path/to/addarr.log
max_size = 10MB
backup_count = 5

Performance Tuning

Cache Settings

[cache]
enabled = true
# Cache duration in minutes
duration = 60
# Maximum cache size
max_size = 1000

Rate Limiting

[limits]
# Requests per minute
rate_limit = 30
# Concurrent searches
max_concurrent = 5
# Search results limit
max_results = 5

Security Features

SSL/TLS Configuration

[security]
verify_ssl = true
cert_file = /path/to/cert.pem
key_file = /path/to/key.pem

Access Control

[access]
# IP whitelist
allowed_ips = 192.168.1.0/24
# Required user roles
required_roles = admin,user

Custom Formatting

Message Templates

[templates]
# Custom message formats
show_template = {title} ({year}) - Rating: {rating}
movie_template = {title} ({year}) - {director}

Integration Options

Webhook Support

[webhooks]
enabled = true
url = https://your-webhook-url
events = grab,download,upgrade

External Scripts

[scripts]
pre_add = /path/to/pre-add.sh
post_add = /path/to/post-add.sh
on_error = /path/to/error-handler.sh

Environment-Specific Settings

Docker Environment

[docker]
config_path = /config
data_path = /data

Proxy Configuration

[proxy]
enabled = false
type = http
host = proxy.example.com
port = 8080
username = proxyuser
password = proxypass

Usage Examples

Example: High-Security Configuration

[security]
verify_ssl = true
cert_file = /certs/addarr.pem
key_file = /certs/addarr.key
[access]
allowed_ips = 10.0.0.0/8
[logging]
debug = true
log_level = DEBUG

Example: Performance-Optimized

[cache]
enabled = true
duration = 120
[limits]
rate_limit = 60
max_concurrent = 10

Best Practices

  1. Security

    • Always use HTTPS for remote access
    • Implement strict IP filtering
    • Regularly rotate API keys
  2. Performance

    • Enable caching for better response times
    • Adjust rate limits based on usage
    • Monitor log files for optimization opportunities
  3. Maintenance

    • Regular backup of configuration
    • Monitor disk space for logs
    • Keep certificates up to date

Clone this wiki locally