Skip to main content
Libredesk is a single binary application that requires postgres and redis to run. You can install it using the binary or docker.

​
Installation Methods

​
Configuration via Environment Variables

Instead of using a config.toml file, you can configure Libredesk entirely through environment variables.
  • All environment variables use the LIBREDESK_ prefix
  • Use double underscore (__) for nested configuration keys
  • To use environment variables exclusively (without a config file), pass --config=""
Example:
TOML ConfigEnvironment Variable
upload.fs.upload_path = "uploads"LIBREDESK_UPLOAD__FS__UPLOAD_PATH=uploads
db.host = "localhost"LIBREDESK_DB__HOST=localhost

​
Nginx Configuration

Libredesk uses WebSockets for real-time updates. If you’re using Nginx as a reverse proxy, you can add a configuration like this: 
server {
    listen 80;
    server_name your-domain.com;
    
    client_max_body_size 100M;
    
    location / {
        proxy_pass http://localhost:9000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_cache_bypass $http_upgrade;
    }
}