Attachments

Note

Attachments from XMPP to Steam require no special configuration.

For sleamdge to bridge attachments from Steam to XMPP, you have two options:

• HTTP Upload: sleamdge will use your XMPP server’s upload component (XEP-0363).

• No upload: sleamdge will copy attachments to a path it can write to. You then need to serve these files from via an HTTP server (eg nginx, prosody’s http_files, etc.).

HTTP Upload

sleamdge can use the HTTP Upload component (XEP-0363) of your XMPP server, if you configure it with upload-service=upload.example.org (see Generic slidge config). In this setting, sleamdge will upload files just like any normal user of your server.

Example 1: prosody’s mod_http_file_share

In sleamdge’s configuration file, use upload-service=upload.example.org

modules_enabled = {
  -- make sure http_file_share is listed here
  "http_file_share";
}

Component "upload.example.org" "http_file_share"
  -- allow sleamdge to use the upload component
  http_file_share_access = { "steam.example.org" }

More info: mod_http_file_share.

Example 2: ejabberd mod_http_upload

In sleamdge’s configuration file, use upload-service=example.org

The subdomain’s FQDN (example.org) should be listed under the top level ‘hosts’.

hosts:
  - "example.org"

acl:
  slidge_acl:
    server:
      - "steam.example.org"

listen:
  -
    port: 5443
    module: ejabberd_http
    tls: true
    request_handlers:
      /upload: mod_http_upload

modules:
  mod_http_upload:
    # Any path that ejabberd has read and write access to
    docroot: /ejabberd/upload
    put_url: "https://@HOST@:5443/upload"
    access:
      - allow: local
      - allow: slidge_acl

To get more information about component configuration, see ejabberd’s docs.

No upload

You need to set up no-upload-path to point to a directory, and no-upload-url-prefix to an URL prefix pointing to files in that directory (see options for more detail). Example: no-upload-path=/var/www/sleamdge-attachments/ and no-upload-url-prefix=https://example.org/sleamdge/ means that /var/www/sleamdge-attachments/some-image.jpg is accessible at https://example.org/sleamdge/some-image.jpg

Make sure that no-upload-path is writeable by sleamdge and readable by your HTTP server. You may use no-upload-file-read-others=true to do that easily, but you might want to restrict which users can read this directory.

Warning

sleamdge will not take care of removing old files, so you should set up a cronjob, a systemd timer, or something similar, to regularly delete files, eg. find . -mtime +7 -delete && find . -depth -type d -empty -delete to clean up files older than a week.

For the following examples, in sleamdge’s config, you would have no-upload-path=/var/lib/sleamdge/attachments.

Example 1: prosody’s http_files

Here, no-upload-url-prefix would be https://example.org:5281/files/, as per the mod_http_files documentation.

modules_enabled = {
  -- make sure http_files is listed here
  "http_files";
}

-- Must be the same value as sleamdge's no-upload-path
http_files_dir = "/var/lib/sleamdge/attachments"

Example 2: nginx

Here, no-upload-url-prefix would be https://example.org/sleamdge/.

server {
  listen 80;
  server_name example.org;
  root /var/www/html;  # if you already have nginx serving files…

  # the section below is for sleamdge
  location /sleamdge {
    #  Must be the same value as sleamdge's no-upload-path
    alias /var/lib/sleamdge/attachments/;
  }
}

See the nginx docs for more info.

Next steps

To make your sleamdge install top notch, set up its privileges.