How to install Ombi on Ubuntu Server

Introduction

Ombi is a self-hosted web application that allows you to manage your media content and request new content. This tutorial will guide you through the process of installing Ombi on an Ubuntu Server.

Prerequisites

• Ubuntu Server (version 18.04 or later)
• Access to a terminal with sudo privileges
• Port 3579 open in firewall settings (to be updated later in the tutorial)

Step-by-Step Guide

1. Update and Upgrade Ubuntu Server

Let's start by ensuring that Ubuntu Server is up-to-date. Open a terminal and enter the following command:

sudo apt update && sudo apt upgrade -y

This command will update your server's package list and upgrade any installed packages with security patches.

2. Install .NET Runtime Environment

Ombi requires .NET Runtime Environment to run, so we need to install it first. To do this, type the following command:

wget https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

Next, install the package by running:

sudo dpkg -i packages-microsoft-prod.deb

Finally, run the update command:

sudo apt update

Now, you can install the .NET Runtime Environment by typing:

sudo apt-get install apt-transport-https && sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-3.1

3. Install Ombi

Next, download and install the latest Ombi release from GitHub. You can do this by running the following command:

sudo mkdir /opt/ombi/

sudo wget https://github.com/Ombi-app/Ombi/releases/download/v4.0.5072/linux-x64.zip -O /opt/ombi/ombi.zip

Unzip the archive:

cd /opt/ombi/
sudo unzip ombi.zip -d ombi
sudo chown -R $USER:$USER ombi

4. Configure Ombi

Create a configuration file for Ombi:

sudo nano /opt/ombi/ombi/appsettings.json

Paste this configuration to the file:

{
  "Authentication": {
    "AllowGuestRequests": true
  },
  "Email": {
    "SmtpServer": "",
    "SmtpPort": 25,
    "SmtpUseSsl": false,
    "SmtpUsername": "",
    "SmtpPassword": "",
    "From": ""
  },
  "Plex": {
    "Enabled": false,
    "Token": "",
    "url": ""
  },
  "Tautulli": {
    "Enabled": false,
    "ApiKey": "",
    "url": ""
  },
  "Emby": {
    "Enabled": false,
    "ApiKey": "",
    "url": ""
  },
  "Jellyfin": {
    "Enabled": false,
    "ApiKey": "",
    "url": ""
  },
  "MediaServer": {
    "Type": "Plex",
    "BaseUrl": "",
    "ApiKey": "",
    "Token": "",
    "Username": "",
    "Password": "",
    "Port": 80
  },
  "ApiKeys": {
    "TheMovieDb": "",
    "OMDb": "",
    "TraktTv": "",
    "IMDb": "",
    "FanArtTv": "",
    "TVDB": "",
    "MusicBrainz": ""
  }
}

Replace the empty quotes with your respective values depending on your setup.

5. Configure Ombi Service

Create a new systemd service file for Ombi by typing:

sudo nano /etc/systemd/system/ombi.service

And paste this into it:

[Unit]
	Description=Ombi
	After=syslog.target network.target

[Service]
	User=$USER
	WorkingDirectory=/opt/ombi/ombi
	ExecStart=/usr/bin/dotnet /opt/ombi/ombi/Ombi.dll
	Restart=always
	RestartSec=10  # Restart service after 10 seconds if it crashes
	SyslogIdentifier=ombi

[Install]
	WantedBy=multi-user.target

Change $USER to your username.

Now reload the systemd daemon:

sudo systemctl daemon-reload

Start the Ombi service:

sudo systemctl enable ombi.service
sudo systemctl start ombi

6. Configure Firewall

To ensure that Ombi is accessible from the network, we need to open up port 3579:

sudo ufw allow 3579/tcp

7. Access Ombi

You can now access Ombi by typing your server's IP address followed by port number 3579 in your browser. e.g. http://your-server-ip:3579/

Conclusion

In this tutorial, we have successfully installed Ombi on Ubuntu Server. You can now configure the application to request new media and manage existing media.