Skip to Content
architectureOverview

Last Updated: 3/8/2026

Architecture Overview

System Architecture

LinkAce is a self-hosted bookmark management application built with modern web technologies.

Technology Stack

Backend:

  • Framework: Laravel (PHP)
  • Database: MySQL, PostgreSQL, or SQLite
  • Queue System: Redis (optional, for background jobs)
  • Cache: Redis or file-based caching

Frontend:

  • UI Framework: Bootstrap
  • JavaScript: Webpack-compiled assets
  • Templating: Blade templates

Infrastructure:

  • Containerization: Docker and Docker Compose
  • Web Server: Nginx (in Docker setup) or Apache/Nginx (standalone)
  • Process Manager: Supervisor (for queue workers)

Core Components

  • Link storage and metadata extraction
  • Automatic title and description generation
  • URL validation and normalization
  • Privacy controls (public/private links)

2. Organization System

  • Tags: Flexible categorization with hierarchical support
  • Lists: Curated collections of links
  • Search: Advanced filtering and full-text search
  • Automated link checking via scheduled jobs
  • HTTP status code validation
  • Broken link detection and notifications
  • Link redirect tracking

4. Archiving Integration

  • Internet Archive Wayback Machine integration
  • Automatic snapshot creation
  • Archive link storage and retrieval

5. User Management

  • Multi-user support with role-based access
  • OAuth 2.0 and OIDC authentication
  • User preferences and settings
  • Sharing capabilities (links, lists, tags)

6. API Layer

  • Full REST API for all core functions
  • Token-based authentication
  • Rate limiting and security controls
  • Zapier integration support

7. Import/Export

  • HTML bookmark import (Netscape format)
  • HTML export functionality
  • Batch operations support

8. Backup System

  • Database backups
  • Application file backups
  • S3-compatible storage support
  • Scheduled backup automation

Data Flow

User Input → Controller → Service Layer → Repository → Database
                ↓
           Queue Jobs (async)
                ↓
         Background Workers
    (Link checks, archiving, etc.)

Deployment Options

  1. Docker Compose (Recommended)

    • Pre-configured containers
    • Easy scaling and updates
    • Isolated environment

  2. Kubernetes/Helm

    • Enterprise-grade orchestration
    • High availability setup
    • Auto-scaling capabilities

  3. Traditional PHP Hosting

    • Shared hosting compatible
    • Manual dependency management
    • Requires PHP 8.1+

  4. Cloud One-Click Deploy

    • Platform-specific templates
    • Automated provisioning
    • Managed infrastructure

Security Features

  • CSRF protection
  • XSS prevention
  • SQL injection protection (via Eloquent ORM)
  • Secure password hashing (bcrypt)
  • API token encryption
  • Rate limiting on API endpoints
  • Optional SSO integration

Performance Considerations

  • Caching: Redis or file-based caching for frequently accessed data
  • Queue System: Async processing for heavy operations
  • Database Indexing: Optimized queries for search and filtering
  • Asset Optimization: Minified and bundled frontend resources

Scalability

  • Horizontal scaling via load balancing
  • Database read replicas support
  • CDN integration for static assets
  • Queue worker scaling for background jobs
From V1Api Reference