A web server that acts as a temporary, browser-based bridge to a remote machine.

file, manager, http, server, ssl, basic, auth
pip install trussws==0.1



Truss is a temporary, browser-based bridge to a remote machine. It will serve and receive files over an SSL connection with basic HTTP authorization. It will shut itself down (after five minutes, by default).

It is meant to augment my usage of python -m SimpleHTTPSever.


The package name is trussws (because 'truss' is taken by something that isn't used in the PyPI), but the executable is 'truss'.


pip install trussws

As a user

pip install --user trussws

From a clone

python install


truss -h
truss myuser mypassword 8000
truss myuser mypassword 8000 --hostname --docroot /path/to/http-temp --lifetime 3h

Be sure to access the server with https://. You'll get a warning; this is caused by the self-signed certificate.


I'm using ChromeOS as my primary development machine (at home and at work). It comes with a shell and ssh client, but to rsync files you need to turn on developer mode. I don't want to do that because

  1. I'm a developer, but I'm not developing for ChromeOS.
  2. It disables the verified boot.
  3. It takes longer to boot up due to a warning about the lack of verification.
  4. The warning has a big computer thing frowning at me that is annoying.

Truss is meant to facilitate development in the cloud. To get stuff off my remote development server, I would frequently run python -m SimpleHTTPServer. To get stuff on to the remote machine, I would copy and paste contents or, if it was too big, upload the file into S3 from a browser and pull it on to the remote machine. This came with some issues:

  1. It's inconvenient to take multiple steps to get something on to a remote machine.
  2. I would often leave the SimpleHTTPServer running acccidentally for long periods of time.
  3. It would be nice to have some authentication to get to what I'm temporarily serving.
  4. It would be nice to do it over SSL.


Copyright 2013 Mason Staugler

See LICENSE; it's the MIT license.