System Settings

Warning: This is the documentation of a beta version of LinkAce. Things may break. Only use this version for tests.

The system settings allow the user to configure the whole application, affecting all users - even if this is a single-user application for now.

Update Checks

Preview of the update check

LinkAce will automatically check for updates on the system settings page. To get this to work, the app pulls information about the latest releases from Github and compares it to your currently installed version.

Cron Token

Preview of th cron token settings

A cron is needed to move certain functionality out of the user actions and schedule certain tasks. The cron is kind of a script that runs tasks on predefined times through day.

The cron token you can access or re-generate in the system settings is needed to properly authenticate your cron script against LinkAce, so no third party can trigger the scheduled tasks.

Currently, the following tasks will be run:

  • LinkAce runs the link check and sends a notification if moved or dead links were found.
  • LinkAce sends requests to the Wayback Machine with all newly added links, so they are backed up later.

Setting up the cron

If you are unsure about setting up a cron, either use a web service like cron-job.org, or search the web for help.

Your cron must run every minute and must open the URL provided in the system settings. A basic unix cron entry may look like this:

*   *   *   *   *   wget -qO- https://linkace-example.com/cron/WPvv4mxM6nr22Aq4rVf1qEKutsXLTgyw > /dev/null

Re-generate the cron token

If you have problems with your current token or think that someone else knows the token, you should generate a new one in the system settings. Click the “Generate Token” button right to the token field and LinkAce will generate a new one.

General Settings

Preview of the general system settings

Page Title

The page title setting allows you to specify the title that is displayed in the browser tab. If left blank, LinkAce will use the default title.

Guest Access

Guest access is an important setting regarding privacy and maybe also security. If turned on, guests will be able to

  • view all links that are not marked as private,
  • view all tags that are not marked as private, and
  • view all categories that are not marked as private.

Regardless of this setting, LinkAce will always show you the option to make links, tags or categories private. This ensures that you can easily switch the guest access on and off without having to update any links.

If you don’t want anyone to view your bookmark collection, leave the guest access disabled.

Custom Header Content

Content entered here will be placed before the tag on all LinkAce sites. Useful to place analytics or customization scripts. Caution: contents are not escaped and may break the site! Use at your own risk.

Guest Settings

These settings apply to all guests visiting your site, if you have guest access enabled.

Preview of the system guest settings

Please check the user settings documentation for more details about all available options, as they are exactly the same.


Advanced System Settings

The following settings can be changed only in the .env file.

APP_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.

  • Possible Value(s): a valid timezone according to PHP
  • Default value: UTC
  • Example: APP_TIMEZONE=Europe/Berlin

APP_USER_AGENT

Change the User Agent that is used in LinkAce to make requests to website. Can be helpful if LinkAce is blocked often by sites when it tries to gather metadata.
Please note that it’s important to wrap the User Agent in quotes (") in your .env file.

  • Possible Value(s): a valid User Agent string
  • Default value: LinkAce/1 (https://github.com/Kovah/LinkAce)
  • Example: APP_USER_AGENT="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.71 Safari/537.36"