Using Traefik with MyLinks on Docker

Traefik is a modern HTTP reverse proxy and load balancer that makes it easy to deploy and manage your services. If you’re running MyLinks on Docker, you can use Traefik to expose your instance securely over HTTPS with automatic SSL certificate management.

Prerequisites

Docker and Docker Compose installed on your system
A domain name pointing to your server’s IP address

Configuration

Configure Traefik and MyLinks

In your docker-compose.override.yml file, add the following configuration:

docker-compose.override.yml

version: '3'
 
services:
    api:
      labels:
        - "traefik.enable=true"
        - "traefik.http.routers.librechat.rule=Host(`your.domain.name`)"
        - "traefik.http.routers.librechat.entrypoints=websecure"
        - "traefik.http.routers.librechat.tls.certresolver=leresolver"
        - "traefik.http.services.librechat.loadbalancer.server.port=3080"
      networks:
        - librechat_default
      volumes:
        - ./librechat.yaml:/app/librechat.yaml
  
    traefik:
      image: traefik:v3.0
      ports:
        - "80:80"
        - "443:443"
      volumes:
        - "/var/run/docker.sock:/var/run/docker.sock:ro"
        - "./letsencrypt:/letsencrypt"
      networks:
        - librechat_default
      command:
        - "--log.level=DEBUG"
        - "--api.insecure=true"
        - "--providers.docker=true"
        - "--providers.docker.exposedbydefault=false"
        - "--entrypoints.web.address=:80"
        - "--entrypoints.websecure.address=:443"
        - "--certificatesresolvers.leresolver.acme.tlschallenge=true"
        - "--certificatesresolvers.leresolver.acme.email=your@email.com"
        - "--certificatesresolvers.leresolver.acme.storage=/letsencrypt/acme.json"
 
# other configs here #
 
# NOTE: This needs to be at the bottom of your docker-compose.override.yml
networks:
  librechat_default:
    external: true

Replace your@email.com with your email address for Let’s Encrypt certificate notifications.

see: Docker Override for more info.

Start the containers

docker-compose up -d

This will start Traefik and MyLinks containers. Traefik will automatically obtain an SSL/TLS certificate from Let’s Encrypt and expose your MyLinks instance securely over HTTPS.

You can now access your MyLinks instance at https://your.domain.name. Traefik will handle SSL/TLS termination and reverse proxy requests to your MyLinks container.

Additional Notes

The Traefik configuration listens on ports 80 and 443 for HTTP and HTTPS traffic, respectively. Ensure that these ports are open on your server’s firewall.
Traefik stores SSL/TLS certificates in the ./letsencrypt directory on your host machine. You may want to back up this directory periodically.
For more advanced configuration options, refer to the official Traefik documentation: https://doc.traefik.io/

Static File Caching and Compression

MyLinks now supports static file caching and compression natively. If you’re using Traefik to handle compression, you should disable compression in MyLinks to avoid redundant processing. You can do this by setting the DISABLE_COMPRESSION environment variable to true in your MyLinks configuration.

# .env file
DISABLE_COMPRESSION=true

This will prevent MyLinks from compressing static files, allowing Traefik to handle compression more efficiently.

For more information on static file handling in MyLinks, including caching options, refer to the Static File Handling documentation.

ngrok Intro