Skip to Content
v2ConfigurationEnv Settings

Last Updated: 3/11/2026


Advanced Settings

The following settings can be added to the .env file and changed as you need them.

# Only relevant for URLs generated when using LinkAce CLI commands # Only relevant for URLs generated when using LinkAce CLI commands # Only relevant for URLs generated when using LinkAce CLI commandsAPP_URL=http://localhost APP_URL=http://localhost = # The environment is usually 'production' but may be changed to 'local' for development # The environment is usually 'production' but may be changed to 'local' for development # The environment is usually 'production' but may be changed to 'local' for developmentAPP_ENV=production APP_ENV=production = # Enable the debug more if you are running into issues or while developing # Enable the debug more if you are running into issues or while developing # Enable the debug more if you are running into issues or while developingAPP_DEBUG=false APP_DEBUG=false = # Change the timezone of the core application here. It does not affect the timezone set in the user settings but changes how LinkAce saves dates and times in the database. Be very careful when using this setting as it can have unintended site effects! There won't be any support for broken applications due to a changed timezone. # Change the timezone of the core application here. It does not affect the timezone set in the user settings but changes how LinkAce saves dates and times in the database. Be very careful when using this setting as it can have unintended site effects! There won't be any support for broken applications due to a changed timezone. # Change the timezone of the core application here. It does not affect the timezone set in the user settings but changes how LinkAce saves dates and times in the database. Be very careful when using this setting as it can have unintended site effects! There won't be any support for broken applications due to a changed timezone.APP_TIMEZONE=UTC APP_TIMEZONE=UTC = # Set the time after a session expires automatically, in minutes. Default is 7 days. You may also define a specific domain. # Set the time after a session expires automatically, in minutes. Default is 7 days. You may also define a specific domain. # Set the time after a session expires automatically, in minutes. Default is 7 days. You may also define a specific domain.SESSION_LIFETIME=10080 SESSION_LIFETIME=10080 = 10080SESSION_DOMAIN= SESSION_DOMAIN= =SESSION_SECURE_COOKIE=[true/false] SESSION_SECURE_COOKIE=[true/false] =[] # Configure the API rate limit here: the first number defines the number of requests, the second the time frame # Configure the API rate limit here: the first number defines the number of requests, the second the time frame # Configure the API rate limit here: the first number defines the number of requests, the second the time frame# for the requests. 60,1 is the default which means: 60 requests per 1 minute # for the requests. 60,1 is the default which means: 60 requests per 1 minute # for the requests. 60,1 is the default which means: 60 requests per 1 minuteAPI_RATE_LIMIT=60,1 API_RATE_LIMIT=60,1 = ## Mail configuration ## Mail configuration ## Mail configurationMAIL_FROM_ADDRESS=[email protected] MAIL_FROM_ADDRESS=[email protected] =MAIL_FROM_NAME=LinkAce MAIL_FROM_NAME=LinkAce =# Set the driver used for sending email here, default is `log` # Set the driver used for sending email here, default is `log` # Set the driver used for sending email here, default is `log`MAIL_MAILER=smtp MAIL_MAILER=smtp = # Set the SMTP host and its port here # Set the SMTP host and its port here # Set the SMTP host and its port hereMAIL_HOST=smtp.mailtrap.io MAIL_HOST=smtp.mailtrap.io =MAIL_PORT=2525 MAIL_PORT=2525 = 2525 # Set the username used to connect to the SMTP server here # Set the username used to connect to the SMTP server here # Set the username used to connect to the SMTP server hereMAIL_USERNAME=null MAIL_USERNAME=null = # Set the password used to connect to the SMTP server here # Set the password used to connect to the SMTP server here # Set the password used to connect to the SMTP server hereMAIL_PASSWORD=null MAIL_PASSWORD=null =# If your SMTP server uses encrypted connections, enable it here by setting the variable to `tls` # If your SMTP server uses encrypted connections, enable it here by setting the variable to `tls` # If your SMTP server uses encrypted connections, enable it here by setting the variable to `tls`MAIL_ENCRYPTION=null MAIL_ENCRYPTION=null =# If you want to use Sendmail, set the path here # If you want to use Sendmail, set the path here # If you want to use Sendmail, set the path hereMAIL_SENDMAIL_PATH="/usr/sbin/sendmail -bs -i" MAIL_SENDMAIL_PATH="/usr/sbin/sendmail -bs -i" ="/usr/sbin/sendmail -bs -i"# If you are using self-signed certificates, add this setting to false to no verify SSL connections # If you are using self-signed certificates, add this setting to false to no verify SSL connections # If you are using self-signed certificates, add this setting to false to no verify SSL connectionsMAIL_VERIFY_TLS=true MAIL_VERIFY_TLS=true = ## Advanced database configuration ## Advanced database configuration ## Advanced database configuration # Some of these configuration options are only available for specific database systems # Some of these configuration options are only available for specific database systems # Some of these configuration options are only available for specific database systemsDB_CONNECTION=mysql DB_CONNECTION=mysql =DB_HOST=127.0.0.1 DB_HOST=127.0.0.1 =DB_PORT=3306 DB_PORT=3306 = 3306DB_DATABASE=linkace DB_DATABASE=linkace =DB_USERNAME=linkace DB_USERNAME=linkace =DB_PASSWORD=superSecurePassword DB_PASSWORD=superSecurePassword = DB_CHARSET=utf8mb4 DB_CHARSET=utf8mb4 =DB_COLLATION=utf8mb4_unicode_ci DB_COLLATION=utf8mb4_unicode_ci =DB_ENGINE=InnoDB DB_ENGINE=InnoDB =DB_SOCKET= DB_SOCKET= =DATABASE_URL="mysql://sandy:[email protected]:3306/db" DATABASE_URL="mysql://sandy:[email protected]:3306/db" ="mysql://sandy:[email protected]:3306/db" # SSL settings for the database connections # SSL settings for the database connections # SSL settings for the database connectionsDB_SSL_MODE=prefer DB_SSL_MODE=prefer =MYSQL_VERIFY_SERVER_CERT=true MYSQL_VERIFY_SERVER_CERT=true =MYSQL_SSL_KEY= MYSQL_SSL_KEY= =MYSQL_SSL_CERT= MYSQL_SSL_CERT= =MYSQL_SSL_CA= = MYSQL_SSL_CA= = = = ## Meta generation ## Meta generation ## Meta generation## Configure how LinkAce should handle HTTP requests when fetching the meta data of websites when adding links. ## Configure how LinkAce should handle HTTP requests when fetching the meta data of websites when adding links. ## Configure how LinkAce should handle HTTP requests when fetching the meta data of websites when adding links.# The user agent may be customized to enhance credibility. # The user agent may be customized to enhance credibility. # The user agent may be customized to enhance credibility.APP_USER_AGENT="LinkAce/1 (https://github.com/Kovah/LinkAce)" APP_USER_AGENT="LinkAce/1 (https://github.com/Kovah/LinkAce)" ="LinkAce/1 (https://github.com/Kovah/LinkAce)"# The timeout is 10 seconds by default. If you encounter failed meta generation more often, consider increasing this. # The timeout is 10 seconds by default. If you encounter failed meta generation more often, consider increasing this. # The timeout is 10 seconds by default. If you encounter failed meta generation more often, consider increasing this.META_GENERATION_TIMEOUT=20 META_GENERATION_TIMEOUT=20 = 20# You also can add custom headers, for example to customize the Accept-Language header. Multiple headers must be separated by a pipe (|). # You also can add custom headers, for example to customize the Accept-Language header. Multiple headers must be separated by a pipe (|). # You also can add custom headers, for example to customize the Accept-Language header. Multiple headers must be separated by a pipe (|).META_GENERATION_CUSTOM_HEADERS="Accept-Language=fr-CH,fr;q=0.9,en|referer=https://example.com" META_GENERATION_CUSTOM_HEADERS="Accept-Language=fr-CH,fr;q=0.9,en|referer=https://example.com" ="Accept-Language=fr-CH,fr;q=0.9,en|referer=https://example.com"# By default, HTML meta is not generated for internal IP ranges. To enable this again, add the following line. # By default, HTML meta is not generated for internal IP ranges. To enable this again, add the following line. # By default, HTML meta is not generated for internal IP ranges. To enable this again, add the following line.META_ALLOW_PRIVATE_IP_RANGES=true META_ALLOW_PRIVATE_IP_RANGES=true = #### Backup configuration #### Backup configuration #### Backup configuration # Enable backups here # Enable backups here # Enable backups hereBACKUP_ENABLED=false BACKUP_ENABLED=false =# Choose the destination of the backup. If you set up AWS S3 credentials below you may choose 'cloud' which is used # Choose the destination of the backup. If you set up AWS S3 credentials below you may choose 'cloud' which is used # Choose the destination of the backup. If you set up AWS S3 credentials below you may choose 'cloud' which is used# as a synonym for AWS. Leave blank or set to 'local_backups' if you want to store backups within /storage/app/backups. # as a synonym for AWS. Leave blank or set to 'local_backups' if you want to store backups within /storage/app/backups. # as a synonym for AWS. Leave blank or set to 'local_backups' if you want to store backups within /storage/app/backups.BACKUP_DISK=s3 BACKUP_DISK=s3 =# You may disable notifications for backups. Not recommended, as possible issues may not be reported. # You may disable notifications for backups. Not recommended, as possible issues may not be reported. # You may disable notifications for backups. Not recommended, as possible issues may not be reported.BACKUP_NOTIFICATIONS_ENABLED=[true/false] BACKUP_NOTIFICATIONS_ENABLED=[true/false] =[]# The notification email may be used to get backup notifications, Mail must be configured for this to work! # The notification email may be used to get backup notifications, Mail must be configured for this to work! # The notification email may be used to get backup notifications, Mail must be configured for this to work!BACKUP_NOTIFICATION_EMAIL=[email protected] BACKUP_NOTIFICATION_EMAIL=[email protected] = # Maximum size of the backups in megabytes # Maximum size of the backups in megabytes # Maximum size of the backups in megabytesBACKUP_MAX_SIZE=512 BACKUP_MAX_SIZE=512 = 512# Backup tasks are run nightly every day. You can change the hour of the executions here # Backup tasks are run nightly every day. You can change the hour of the executions here # Backup tasks are run nightly every day. You can change the hour of the executions hereBACKUP_CLEAN_HOUR="01:00" BACKUP_CLEAN_HOUR="01:00" ="01:00"BACKUP_RUN_HOUR="02:00" BACKUP_RUN_HOUR="02:00" ="02:00" ## Amazon Web Services (AWS) S3 configuration ## Amazon Web Services (AWS) S3 configuration ## Amazon Web Services (AWS) S3 configuration# Define the key ID, the access key, the region and your bucket name here if you want to use AWS S3 for backups. # Define the key ID, the access key, the region and your bucket name here if you want to use AWS S3 for backups. # Define the key ID, the access key, the region and your bucket name here if you want to use AWS S3 for backups.AWS_ACCESS_KEY_ID= AWS_ACCESS_KEY_ID= =AWS_SECRET_ACCESS_KEY= AWS_SECRET_ACCESS_KEY= =AWS_DEFAULT_REGION=us-east-1 AWS_DEFAULT_REGION=us-east-1 =AWS_BUCKET= AWS_BUCKET= = # Advanced S3 settings, only use them if you know what you are doing # Advanced S3 settings, only use them if you know what you are doing # Advanced S3 settings, only use them if you know what you are doingAWS_SCHEME=https AWS_SCHEME=https =AWS_BUCKET_ENDPOINT=[true/false] AWS_BUCKET_ENDPOINT=[true/false] =[]AWS_PATH_STYLE_ENDPOINT=[true/false] AWS_PATH_STYLE_ENDPOINT=[true/false] =[]AWS_ACCELERATE_ENDPOINT=[true/false] AWS_ACCELERATE_ENDPOINT=[true/false] =[]AWS_FIPS_ENDPOINT=[true/false] AWS_FIPS_ENDPOINT=[true/false] =[]AWS_DUAL_STACK_ENDPOINT=[true/false] AWS_DUAL_STACK_ENDPOINT=[true/false] =[] ## Redis cache configuration ## Redis cache configuration ## Redis cache configuration # Set the Redis connection here if you want to use it # Set the Redis connection here if you want to use it # Set the Redis connection here if you want to use itREDIS_HOST=127.0.0.1 REDIS_HOST=127.0.0.1 =REDIS_PASSWORD=ChangeThisToASecurePassword! REDIS_PASSWORD=ChangeThisToASecurePassword! =REDIS_PORT=6379 REDIS_PORT=6379 = 6379REDIS_DB=0 REDIS_DB=0 = 0 ## Memcache cache configuration ## Memcache cache configuration ## Memcache cache configurationMEMCACHED_PERSISTENT_ID= MEMCACHED_PERSISTENT_ID= =MEMCACHED_USERNAME= MEMCACHED_USERNAME= =MEMCACHED_PASSWORD= MEMCACHED_PASSWORD= =MEMCACHED_HOST=127.0.0.1 MEMCACHED_HOST=127.0.0.1 =MEMCACHED_PORT=11211 MEMCACHED_PORT=11211 = 11211 # You can completely disable all audit logs for LinkAce with this option # You can completely disable all audit logs for LinkAce with this option # You can completely disable all audit logs for LinkAce with this optionAUDITING_ENABLED=[true/false] AUDITING_ENABLED=[true/false] =[] # Set some trusted proxies if you want to enhance the security of LinkAce when it's running behind a proxy. # Set some trusted proxies if you want to enhance the security of LinkAce when it's running behind a proxy. # Set some trusted proxies if you want to enhance the security of LinkAce when it's running behind a proxy.TRUSTED_PROXIES=* TRUSTED_PROXIES=* = # Configure LinkAce to report errors to Sentry.io # Configure LinkAce to report errors to Sentry.io # Configure LinkAce to report errors to Sentry.ioSENTRY_LARAVEL_DSN= SENTRY_LARAVEL_DSN= =SENTRY_TRACES_SAMPLE_RATE=0.0 SENTRY_TRACES_SAMPLE_RATE=0.0 = --- --- ## You probably do not want to change any values below. Only continue if you know what you are doing. ## You probably do not want to change any values below. Only continue if you know what you are doing. ## You probably do not want to change any values below. Only continue if you know what you are doing.## If you are using Redis, you may switch SESSION_DRIVER and CACHE_DRIVER to "redis" or "memcache" to improve performance. ## If you are using Redis, you may switch SESSION_DRIVER and CACHE_DRIVER to "redis" or "memcache" to improve performance. ## If you are using Redis, you may switch SESSION_DRIVER and CACHE_DRIVER to "redis" or "memcache" to improve performance.SESSION_DRIVER=file SESSION_DRIVER=file =LOG_CHANNEL=stack LOG_CHANNEL=stack =BROADCAST_DRIVER=log BROADCAST_DRIVER=log =CACHE_DRIVER=file CACHE_DRIVER=file =QUEUE_DRIVER=database QUEUE_DRIVER=database = ## Using Redis sockets ## Using Redis sockets ## Using Redis sockets# If you want to use Redis via a Unix socket, you can remove the hash before the following lines, but remove one before # If you want to use Redis via a Unix socket, you can remove the hash before the following lines, but remove one before # If you want to use Redis via a Unix socket, you can remove the hash before the following lines, but remove one before# the "CACHE_DRIVER" line above. Also, set a proper path to your Redis socket. # the "CACHE_DRIVER" line above. Also, set a proper path to your Redis socket. # the "CACHE_DRIVER" line above. Also, set a proper path to your Redis socket.CACHE_DRIVER=redis-socket CACHE_DRIVER=redis-socket =SESSION_CONNECTION=redis-socket SESSION_CONNECTION=redis-socket =REDIS_SCHEME=unix REDIS_SCHEME=unix =REDIS_PATH=/path/to/redis.sock REDIS_PATH=/path/to/redis.sock =