Gooby to Omni

Gooby to Omni upgrade guide

Congratulations on your decision to upgrade to OmniStream. Lots of improvements and new features are ahead of you… but you need to know a few things before you jump across.

Who is this tutorial for?

If you are upgrading from Gooby to OmniStream, then follow this tutorial. If you are starting from scratch with OmniStream, you need to skip this tutorial altogether - it’s not for you.

Why upgrade?

You can stay with Gooby indefinitely if you wish. It’s not going anywhere, though we won’t be actively maintaining it any longer. OmniStream has many advantages; just a few highlights:

  • Multi user support: everything is in the user home folder - including the mounts.

  • Full support of Traefik, with all its advantages such as a single domain certificate if used in conjunction with CloudFlare - no more Let’s Encrypt bans.

  • Omni can create and remove subdomains on the fly - you won't need to manually create your A records ever again.

  • More customizations than ever, plus a vastly improved menu system - maintaining your media server couldn't be easier.

Last but not least, OmniStream is 100% dockerized now, including Rclone and MergerFS - you will never be “waiting on mounts” again!

Backup! Backup! Backup!

We don’t want you to lose your hair (if you already lost it, don’t blame us), so we have taken every precaution possible to ensure that your precious data is safe. However things can go wrong, so we can’t say this enough: make sure you make a backup of Gooby first! Please acknowledge the following disclaimer:

  • This software is supplied "AS IS" without any warranties and support. You are solely responsible for determining whether OmniStream is compatible with your equipment and other software installed on your system. Make sure you have a backup of all your important data!

Seriously, don’t skip that backup! With that out of the way, let’s continue.

Finish syncing

Make sure no one is watching, downloading, or otherwise using anything from Gooby before starting. This includes ensuring that all sync processes are complete - such as Torrent/Usenet downloads or uploads to your cloud service.

Custom containers

If you have custom components (yaml files), you will need to copy the content first and adapt those to Omni (Traefik) manually, because they will not automatically port over. You will find more information in the documentation about Custom Containers. If you need assistance, feel absolutely free to open a support request on GitHub - we’re here to help!

After your Gooby conversion you can still find your old components in /tmp/components - they will be there until you reboot.

How to upgrade

To start, run

omni-upgrade

The upgrade will start and prompt you to follow the tutorial to install OmniStream and set up CloudFlare (optional, but highly recommended).

  • Pro tip: you don’t need to set up Rclone again. Choose YES to configure Rclone, then just enter the letter Q to quit the config. Select your drive name (coming from Gooby, you probably see Gdrive and Local - in that case, pick Gdrive).

After finishing the upgrade script, log out and back in, then finalize your installation to get Omni up and running.

Not done yet!

With Omni up and running now, make sure that you read this important information afterwards! There are quite a few changes in Omni, some of which require action from you.