Skip to Content
ReferenceCLI Commands

Last Updated: 3/11/2026

LinkAce provides several CLI commands for maintenance, user management, and automation. All commands are run using Laravel’s Artisan console.

Running Commands

For Docker installations, prefix commands with:

docker exec -it linkace_app_1 php artisan [command]

For non-Docker installations:

php artisan [command]

User Management

Create a User

php artisan registeruser

Creates a new user interactively. Add --admin to create an admin user:

php artisan registeruser --admin

List Users

php artisan users:list

Displays all users with their ID, name, email, and role.

Reset User Password

php artisan user:reset-password

Resets a user’s password interactively.

View Recovery Codes

php artisan user:recovery-codes

Displays two-factor authentication recovery codes for a user.

php artisan links:check

Checks the status of links (OK, moved, or broken). By default, checks up to 20 links per user that haven’t been checked in the last 2 months.

Options:

  • --limit=N — Check up to N links per user
  • --noWait — Skip the 1-second delay between requests (use cautiously to avoid rate limiting)

This command runs automatically on a schedule (daily by default).

php artisan links:update-thumbnails

Regenerates thumbnails for links.

Backups

Run Backup

php artisan backup:run

Creates a full backup of the application and database.

List Backups

php artisan backup:list

Shows all available backups.

Clean Old Backups

php artisan backup:clean

Removes old backups according to retention policy.

Import and Export

Import Bookmarks

php artisan import:bookmarks {file}

Imports bookmarks from an HTML file (Netscape bookmark format).

Setup and Maintenance

Complete Setup

php artisan setup:complete

Finalizes the LinkAce setup after manual database migration. Used during installation if the web-based setup fails.

Check Mail Configuration

php artisan mail:check

Sends a test email to verify mail settings.

Migrate Database

php artisan migrate

Runs database migrations. Used during upgrades.

Clear Cache

php artisan cache:clear
php artisan config:clear
php artisan view:clear

Clears application, configuration, and view caches. Useful after configuration changes.

Scheduling

LinkAce uses Laravel’s scheduler to run automated tasks. The following tasks run automatically:

  • Link checks — Daily at 3:00 AM
  • Backups — Daily at 2:00 AM (if enabled)
  • Backup cleanup — Daily at 1:00 AM (if enabled)

To enable scheduling, ensure the cron job is configured (Docker setups include this automatically).

What’s Next

  • API: Access LinkAce programmatically with API tokens
API Reference