Configuring remote access

You can access the OneSwarm interface from any computer by enabling remote access in the OneSwarm settings.

Expand the 'Remote access' section and check the 'Enable remote access to OneSwarm' checkbox. Enter your username and password and click 'Save'. Local and remote addresses through which you can access OneSwarm remote access are shown.

Remote access is via HTTPS, and OneSwarm generates a self-signed certificate to authenticate the connection. You may wish to connect to OneSwarm on a trusted network when you first accept this certificate.

Configuring remote access via a remote proxy

NOTE: This is for advanced users only. Don't do this if reverse proxy doesn't sound familiar to you.

There are cases when you have an Apache httpd server listening for incoming connexions behind a router, which is connected to internet. You may want to access oneswarm by telling this Apache server to reverse-proxy the requests. Here's how:

In the apache configuration file, you will need a block like this:

<Directory proxy:http://127.0.0.1:29616/*>
   Order deny,allow
   Deny from all
</Directory>
RewriteRule ^/oneswarm/(.*) http://127.0.0.1:29616/$1 [P]
RewriteRule ^/127.0.0.1:29616/(.*)$ https://my.securedomain.com/oneswarm/$1 [R]

Replace my.securedomain.com by your domain name, and 29616 by the remote port of oneswarm. Of course, other directives are mandatory (along with mod_rewrite, mod_ssl, and mod_proxy modules), so don't forget :

RewriteEngine On
RewriteLogLevel 0 # you don't want debug
RewriteLog "/some/path/rewrite_log"

SSLProxyEngine On # or else you can reverse proxy an https site
SSLProxyVerify none # important : apache should not try to check oneswarm certificate

ProxyRequests On

Now, your oneswarm is accessible trough https://my.securedomain.com/oneswarm/ - authentication is unchanged.