# Settings Type: object Schema: [Settings](https://sourcey-azuracast.pages.dev/docs/api/models/settings/index.md) - `app_unique_identifier` (optional) Type: string - `base_url` (optional) Type: string; nullable Site Base URL Example: ```json "https://your.azuracast.site" ``` - `instance_name` (optional) Type: string; nullable AzuraCast Instance Name Example: ```json "My AzuraCast Instance" ``` - `prefer_browser_url` (optional) Type: boolean Prefer Browser URL (If Available) Example: ```json "false" ``` - `use_radio_proxy` (optional) Type: boolean Use Web Proxy for Radio Example: ```json "false" ``` - `history_keep_days` (optional) Type: integer Days of Playback History to Keep - `always_use_ssl` (optional) Type: boolean Always Use HTTPS Example: ```json "false" ``` - `api_access_control` (optional) Type: string; nullable API 'Access-Control-Allow-Origin' header Example: ```json "*" ``` - `enable_liquidsoap_editing` (optional) Type: boolean Allow stations to manually edit Liquidsoap code. Example: ```json "true" ``` - `enable_all_webhooks` (optional) Type: boolean Allow stations to dispatch webhooks. Example: ```json "true" ``` - `filter_local_user_urls` (optional) Type: boolean Prevent users from using local IPs or URLs in Webhooks, etc. Example: ```json "true" ``` - `enable_static_nowplaying` (optional) Type: boolean Whether to use high-performance static JSON for Now Playing data updates. Example: ```json "false" ``` - `analytics` (optional) Type: unknown; nullable Listener Analytics Collection oneOf: Reference: [AnalyticsLevel](https://sourcey-azuracast.pages.dev/docs/api/models/analyticslevel/index.md); Type: string enum: ["all","no_ip","none"] - `check_for_updates` (optional) Type: boolean Check for Updates and Announcements Example: ```json "true" ``` - `update_results` (optional) Type: unknown; nullable Results of the latest update check. Example: ```json "" ``` oneOf: Reference: [Api_Admin_UpdateDetails](https://sourcey-azuracast.pages.dev/docs/api/models/api-admin-updatedetails/index.md); Type: object - `update_last_run` (optional) Type: integer The UNIX timestamp when updates were last checked. Example: ```json 1609480800 ``` - `public_theme` (optional) Type: unknown; nullable Base Theme for Public Pages Example: ```json "light" ``` oneOf: Reference: [SupportedThemes](https://sourcey-azuracast.pages.dev/docs/api/models/supportedthemes/index.md); Type: string enum: ["browser","light","dark"] - `hide_album_art` (optional) Type: boolean Hide Album Art on Public Pages Example: ```json "false" ``` - `homepage_redirect_url` (optional) Type: string; nullable Homepage Redirect URL Example: ```json "https://example.com/" ``` - `default_album_art_url` (optional) Type: string; nullable Default Album Art URL Example: ```json "https://example.com/image.jpg" ``` - `use_external_album_art_when_processing_media` (optional) Type: boolean Attempt to fetch album art from external sources when processing media. Example: ```json "false" ``` - `use_external_album_art_in_apis` (optional) Type: boolean Attempt to fetch album art from external sources in API requests. Example: ```json "false" ``` - `last_fm_api_key` (optional) Type: string; nullable An API key to connect to Last.fm services, if provided. Example: ```json "SAMPLE-API-KEY" ``` - `hide_product_name` (optional) Type: boolean Hide AzuraCast Branding on Public Pages Example: ```json "false" ``` - `public_custom_css` (optional) Type: string; nullable Custom CSS for Public Pages Example: ```json "" ``` - `public_custom_js` (optional) Type: string; nullable Custom JS for Public Pages Example: ```json "" ``` - `internal_custom_css` (optional) Type: string; nullable Custom CSS for Internal Pages Example: ```json "" ``` - `backup_enabled` (optional) Type: boolean Whether backup is enabled. Example: ```json "false" ``` - `backup_time_code` (optional) Type: string; nullable The timecode (i.e. 400 for 4:00AM) when automated backups should run. Example: ```json 400 ``` - `backup_exclude_media` (optional) Type: boolean Whether to exclude media in automated backups. Example: ```json "false" ``` - `backup_keep_copies` (optional) Type: integer Number of backups to keep, or infinite if zero/null. Example: ```json 2 ``` - `backup_storage_location` (optional) Type: integer; nullable The storage location ID for automated backups. Example: ```json 1 ``` - `backup_format` (optional) Type: string; nullable The output format for the automated backup. Example: ```json "zip" ``` - `backup_last_run` (optional) Type: integer The UNIX timestamp when automated backup was last run. Example: ```json 1609480800 ``` - `backup_last_output` (optional) Type: string; nullable The output of the latest automated backup task. Example: ```json "" ``` - `setup_complete_time` (optional) Type: integer The UNIX timestamp when setup was last completed. Example: ```json 1609480800 ``` - `sync_disabled` (optional) Type: boolean Temporarily disable all sync tasks. Example: ```json "false" ``` - `sync_last_run` (optional) Type: integer The last run timestamp for the unified sync task. Example: ```json 1609480800 ``` - `external_ip` (optional) Type: string; nullable This installation's external IP. Example: ```json "192.168.1.1" ``` - `geolite_license_key` (optional) Type: string; nullable The license key for the Maxmind Geolite download. Example: ```json "" ``` - `geolite_last_run` (optional) Type: integer The UNIX timestamp when the Maxmind Geolite was last downloaded. Example: ```json 1609480800 ``` - `mail_enabled` (optional) Type: boolean Enable e-mail delivery across the application. Example: ```json "true" ``` - `mail_sender_name` (optional) Type: string; nullable The name of the sender of system e-mails. Example: ```json "AzuraCast" ``` - `mail_sender_email` (optional) Type: string; nullable The e-mail address of the sender of system e-mails. Example: ```json "example@example.com" ``` - `mail_smtp_host` (optional) Type: string; nullable The host to send outbound SMTP mail. Example: ```json "smtp.example.com" ``` - `mail_smtp_port` (optional) Type: integer The port for sending outbound SMTP mail. Example: ```json 465 ``` - `mail_smtp_username` (optional) Type: string; nullable The username when connecting to SMTP mail. Example: ```json "username" ``` - `mail_smtp_password` (optional) Type: string; nullable The password when connecting to SMTP mail. Example: ```json "password" ``` - `mail_smtp_secure` (optional) Type: boolean Whether to use a secure (TLS) connection when sending SMTP mail. Example: ```json "true" ``` - `avatar_service` (optional) Type: string; nullable The external avatar service to use when fetching avatars. Example: ```json "libravatar" ``` - `avatar_default_url` (optional) Type: string; nullable The default avatar URL. Example: ```json "" ``` - `acme_email` (optional) Type: string; nullable ACME (LetsEncrypt) e-mail address. Example: ```json "" ``` - `acme_domains` (optional) Type: string; nullable ACME (LetsEncrypt) domain name(s). Example: ```json "" ``` - `ip_source` (optional) Type: unknown; nullable IP Address Source oneOf: Reference: [IpSources](https://sourcey-azuracast.pages.dev/docs/api/models/ipsources/index.md); Type: string enum: ["local","xff","cloudflare"]