[Enhancement]: Declarative config #2886

Open
opened 2026-04-25 00:11:35 +02:00 by adam · 4 comments
Owner

Originally created by @vehagn on GitHub (Jul 12, 2025).

Type of Enhancement

Server Backend

Describe the Feature/Enhancement

Configure ABS using declarative configuration following IaC principles.

Why would this be helpful?

Employing ClickOps to configure ABS makes it harder to reproduce the current configuration without a backend.

Future Implementation (Screenshot)

Using a JSON or YAML file to configure ABS.

Audiobookshelf Server Version

v2.24.0

Current Implementation (Screenshot)

No response

Originally created by @vehagn on GitHub (Jul 12, 2025). ### Type of Enhancement Server Backend ### Describe the Feature/Enhancement Configure ABS using declarative configuration following IaC principles. ### Why would this be helpful? Employing ClickOps to configure ABS makes it harder to reproduce the current configuration without a backend. ### Future Implementation (Screenshot) Using a JSON or YAML file to configure ABS. ### Audiobookshelf Server Version v2.24.0 ### Current Implementation (Screenshot) _No response_
adam added the enhancement label 2026-04-25 00:11:35 +02:00
Author
Owner

@advplyr commented on GitHub (Jul 12, 2025):

Please provide as much detail as you can in your feature requests.

@advplyr commented on GitHub (Jul 12, 2025): Please provide as much detail as you can in your feature requests.
Author
Owner

@vehagn commented on GitHub (Jul 12, 2025):

I'm not sure which details you're asking for.

I know asking for a way of configuring ABS using a config file is a huge task, but I would certainly really appreciate the ability of just giving ABS a file and having everything configured, e.g.

libraries:
  - id: fiction
    name: Fiction
    media_type: books 
    folders:
      - /audiobooks/fiction
    use_square_book_covers: true

authentication:
  password_authentication_enabled: false
  oidc:
    enabled: true
    issuer_url: https://auth.example.com
    client_id: audiobookshelf
    client_secret: super_secret
    signing_algorithm: ES256
@vehagn commented on GitHub (Jul 12, 2025): I'm not sure which details you're asking for. I know asking for a way of configuring ABS using a config file is a huge task, but I would certainly really appreciate the ability of just giving ABS a file and having everything configured, e.g. ```yaml libraries: - id: fiction name: Fiction media_type: books folders: - /audiobooks/fiction use_square_book_covers: true authentication: password_authentication_enabled: false oidc: enabled: true issuer_url: https://auth.example.com client_id: audiobookshelf client_secret: super_secret signing_algorithm: ES256 ```
Author
Owner

@nichwall commented on GitHub (Jul 13, 2025):

Related to https://github.com/advplyr/audiobookshelf/issues/3119

@nichwall commented on GitHub (Jul 13, 2025): Related to https://github.com/advplyr/audiobookshelf/issues/3119
Author
Owner

@Blarc commented on GitHub (Jan 28, 2026):

I'd love this feature as well and probably anyone that practices GitOps. The idea is to be able to easily re-deploy ABS from scratch with everything already configured.

@Blarc commented on GitHub (Jan 28, 2026): I'd love this feature as well and probably anyone that practices GitOps. The idea is to be able to easily re-deploy ABS from scratch with everything already configured.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#2886