Skip to Content
🚀 Getting StartedPost Setup Steps

Last Updated: 3/13/2026

Post-Setup Steps

After installing LinkAce, complete these essential configuration steps to get your instance ready for use.

1. Create Your First User

Via Web Interface

  1. Navigate to your LinkAce URL in a browser
  2. You’ll be redirected to the setup wizard
  3. Fill in the registration form:
    • Username
    • Email address
    • Password (minimum 10 characters)
  4. Click “Create Account”

The first user created automatically becomes an administrator.

Via Command Line

Alternatively, create a user via the command line:

# Docker
docker-compose exec linkace php artisan linkace:setup
 
# Without Docker
php artisan linkace:setup

Follow the prompts to create your admin account.

2. Configure System Settings

After logging in, navigate to Settings → System Settings to configure:

General Settings

  • Site Title: Customize the name displayed in the browser
  • Guest Access: Allow or restrict public access to links
  • Registration: Enable/disable new user registrations
  • Language: Set the default interface language
  • Private by Default: Make all new links private automatically
  • Check Links: Enable automatic link availability checking
  • Archive Links: Automatically save links to the Internet Archive

Search Settings

  • Search Provider: Configure which search engine to use for link previews
  • Results per Page: Set default pagination limits

3. Set Up Email Notifications

Configure email settings to receive notifications about broken links and system events.

SMTP Configuration

Edit your .env file:

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=your-email@example.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=linkace@example.com
MAIL_FROM_NAME="${APP_NAME}"

Test Email Configuration

# Docker
docker-compose exec linkace php artisan linkace:test-email your@email.com
 
# Without Docker
php artisan linkace:test-email your@email.com

4. Configure Backups (Optional)

LinkAce supports automated backups to S3-compatible storage.

S3 Configuration

Add to your .env file:

BACKUP_ENABLED=true
BACKUP_DISK=s3
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your-bucket-name
AWS_ENDPOINT=https://s3.amazonaws.com

Schedule Backups

Backups run automatically via the Laravel scheduler. Ensure your cron job is configured:

* * * * * cd /path/to/linkace && php artisan schedule:run >> /dev/null 2>&1

Manual Backup

Run a backup manually:

# Docker
docker-compose exec linkace php artisan backup:run
 
# Without Docker
php artisan backup:run

5. Set Up OAuth/OIDC (Optional)

Enable single sign-on with OAuth or OpenID Connect providers.

Configuration

Add to your .env file:

# Generic OAuth
OAUTH_ENABLED=true
OAUTH_CLIENT_ID=your-client-id
OAUTH_CLIENT_SECRET=your-client-secret
OAUTH_REDIRECT_URI=https://linkace.example.com/auth/callback
OAUTH_AUTHORIZE_URL=https://provider.com/oauth/authorize
OAUTH_TOKEN_URL=https://provider.com/oauth/token
OAUTH_USER_URL=https://provider.com/oauth/user
 
# Or use OIDC
OIDC_ENABLED=true
OIDC_DISCOVERY_URL=https://provider.com/.well-known/openid-configuration
OIDC_CLIENT_ID=your-client-id
OIDC_CLIENT_SECRET=your-client-secret

Supported Providers

LinkAce works with any OAuth 2.0 or OIDC provider, including:

  • Keycloak
  • Authentik
  • Auth0
  • Okta
  • Azure AD
  • Google Workspace

6. Import Existing Bookmarks

If you’re migrating from another bookmark manager:

  1. Export your bookmarks to HTML format
  2. Navigate to Settings → Import
  3. Upload your HTML file
  4. Select import options:
    • Skip duplicates
    • Make all links private
    • Check links after import
  5. Click “Start Import”

Large imports are processed in the background via the queue system.

7. Install Browser Bookmarklet

Add the LinkAce bookmarklet to quickly save links:

  1. Navigate to Settings → Bookmarklet
  2. Drag the “Add to LinkAce” button to your bookmarks bar
  3. Click the bookmarklet on any page to save it to LinkAce

8. Configure API Access (Optional)

Generate an API token for external integrations:

  1. Navigate to Settings → API
  2. Click “Generate New Token”
  3. Copy the token (it won’t be shown again)
  4. Use the token in API requests:
curl -H "Authorization: Bearer YOUR_TOKEN" \
     https://linkace.example.com/api/v1/links

9. Set Up Zapier Integration (Optional)

Connect LinkAce to 2500+ apps via Zapier:

  1. Visit the LinkAce Zapier integration 
  2. Connect your LinkAce account using your API token
  3. Create Zaps to automate bookmark workflows

10. Enable RSS Feeds

Share your bookmarks via RSS:

  1. Navigate to Settings → User Settings
  2. Enable “Public RSS Feed”
  3. Copy your personal RSS feed URL
  4. Share with RSS readers or embed on websites

Security Recommendations

Production Checklist

  • Set APP_DEBUG=false in production
  • Use HTTPS with a valid SSL certificate
  • Set a strong APP_KEY
  • Use strong database passwords
  • Enable automatic security updates
  • Configure regular backups
  • Limit user registrations if not needed
  • Review user permissions regularly

Firewall Configuration

Ensure only necessary ports are exposed:

  • Port 80 (HTTP) - redirect to HTTPS
  • Port 443 (HTTPS)
  • Database ports should NOT be publicly accessible

Performance Optimization

For better performance, use Redis for caching and sessions:

CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
 
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

Enable OPcache

Ensure PHP OPcache is enabled in your php.ini:

opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.revalidate_freq=2

Next Steps

Setup With DockerSetup Without Docker