Documentation
API reference

Start here

Search every guideesc close

Start here

Welcome to tofa

Set up a server, install the apps, and start watching.

2 min read

tofa is a media server you run yourself. You point it at your own movies and shows, and watch them from the tofa apps on your devices. Your files stay on your machine.

tofa is for media you have the right to use, such as discs you own, files you bought, or videos you made. You are responsible for what you add to your library and share with your household, family and friends. We don't supply, host, or find content, and we handle copyright notices under our Terms.

There are two pieces:

  • Your server. One small program on a computer you control. It reads your media folders, organizes your library, finds artwork, and streams to your devices.
  • The apps. Sign in with your tofa account and your server shows up, ready to play. The same account works on every device.

One small install#

The server is one program that manages everything itself, including its own database and automatic backups. The setup we recommend is Docker: one container, one line to install, on a Linux box or a NAS. Native installers for Linux, macOS, and Windows are there when you'd rather skip Docker. The native installers include the database and playback tools the server needs.

You'll need a computer that stays on, your media in folders, and a tofa account. Create a free account and verify your email. Run your tofa server walks through setup for each platform.

If someone has invited you to their server, you can skip the server install. Create your account, accept the invitation, and get an app. The device guide covers signing in and setup.

During the beta#

  • New builds ship often. tofa shows an update banner in the web interface, and on most setups it can apply the update for you. Where it can't, the banner tells you exactly what to run.
  • Rough edges are normal. When you hit one, telling us is the most useful thing you can do. Getting help & feedback covers what to send.
  • Your data survives updates. Everything tofa stores lives in one data folder and is backed up automatically.