A secure private file host program. Bandwidth & request rate limiting, file sanitizing, good on resources, ShareX compatibility, and more.
Go to file
vysion fa2929994f Structured JSON responses 2022-03-30 12:17:11 -07:00
api Update version to 1.4.0, encryption options in config 2022-03-30 11:54:17 -07:00
conf Update version to 1.4.0, encryption options in config 2022-03-30 11:54:17 -07:00
constants Update version to 1.4.0, encryption options in config 2022-03-30 11:54:17 -07:00
encryption Add DeriveKey func 2022-03-30 12:16:16 -07:00
example update examples, upgrade sharex config example to 13.7.0 2022-03-22 20:13:15 -07:00
global Minor fixes 2022-03-30 12:16:45 -07:00
logger Minor fixes 2022-03-30 12:16:45 -07:00
middleware Structured JSON responses 2022-03-30 12:17:11 -07:00
response add logger, remove unncecessary code 2022-03-22 20:15:29 -07:00
routes Update routes to return structured JSON 2022-03-30 12:15:45 -07:00
security Rename package 2022-03-30 12:15:10 -07:00
utils Update utils 2022-03-30 12:14:49 -07:00
.gitignore update readme and gitignore 2022-03-22 20:12:05 -07:00
Dockerfile Reworked project structure 2021-09-08 16:37:19 -07:00
LICENSE update license year 2022-03-22 20:13:33 -07:00
README.md Clarity on encryption related topic 2022-03-30 12:14:34 -07:00
go.mod Update version to 1.4.0, encryption options in config 2022-03-30 11:54:17 -07:00
go.sum Update version to 1.4.0, encryption options in config 2022-03-30 11:54:17 -07:00
init.go Update init.go and main.go 2022-03-30 12:13:35 -07:00
main.go Update init.go and main.go 2022-03-30 12:13:35 -07:00

README.md

Tytanium

Tytanium is a private file host program, meant for a single user or a small group. Here are the main highlights:

  • SHA2-512 file encryption at rest, with an encryption key unique to each file
  • Tune the server to exactly how you want with extensive customization options
  • Works well with image capture suites, such as ShareX/MagicCap
  • Good on system resources (<1MiB memory usage when idle)
  • Limit how many requests/second to certain paths to prevent DoS attacks or an overloaded server
  • Not written in Javascript!

Please note that files are NOT encrypted client-side; encryption is done on the server.

Setup

  1. Download the binary in the Releases tab, or build the code from source.
  2. Rename example.yml to config.yml and set the values you want, or create a config.yml from scratch.
  3. Mark the binary as executable (this can be done with chmod).

How to Upload

  1. Create a POST request to /upload with a file in the field "file". Put the key in the Authorization header.
  2. Set ?omitdomain=1, if you don't want the host's original domain appended before the file name in the response. For example: a.png instead of https://a.com/a.png. This is useful if you have vanity/proxy domains you want to use.
  3. The server will respond with JSON with fields uri and encryption_key. uri will be just the file name if ?omitdomain=1 was specified.

Optional stuff

  • You can use the Size Checker program to make the /stats path produce values other than 0 for file count and total size used. Just tell it to check your files directory. You can run it as a cron job or run it manually whenever you want to update it. (If you choose not to use it, /stats will always return 0 for some fields.)
  • If you want to change the favicon, replace routes/favicon.ico with your own image.

License

MIT License