Advanced Topics

Configure Obico Server using .env

You can further configure Obico Server using the .env file.

caution

Configuring Obico Server using the .env file is for advanced users. If incorrectly configured, Obico Server may not start up or function correctly.

1. In obico-server directory, make a copy of dotenv.example and rename the copy as .env. If you are on a Linux the server, run cp dotenv.example .env.

caution

The .env file name is NOT a typo. Please don't name the file env. Otherwise Obico Server won't try to read that file.

2. Open .env using your favorite editor.

3. Go through the lines in the file, and remove the leading # on the lines that you intend to change. Please do NOT remove the leading # on any line that you don't understand or don't intend to change. It may cause unexpected server behaviors.

Other advanced server setups

📄️ Firewall configuration on Windows, Mac, and Linux

Security Warning: The guide below only cover the basic steps to set up firewall for self-hosted Obico Server. The setup required to properly secure your private network is too complicated to be covered here. Please do your own research to gather the necessary info before you proceed.

📄️ Configure Obico to work with a reverse proxy

Security Warning: The guide below only cover the basic steps to set up a reverse proxy for self-hosted Obico Server. The setup required to properly secure your private network is too complicated to be covered here. Please do your own research to gather the necessary info before you proceed.

📄️ Obico Reverse Proxy with NGINX Proxy Manager

Security Warning: The guide below only cover the basic steps to set up a reverse proxy for self-hosted Obico Server. The setup required to properly secure your private network is too complicated to be covered here. Please do your own research to gather the necessary info before you proceed.

📄️ Running Obico Server with Nvidia GPU acceleration

This is only available on Linux based host machines.

📄️ Configure a Gmail account as SMTP server to send emails

This is a community-contributed guide. This guide is based on certain Obico community members' own setup and hence may not work for you.

📄️ Email setup troubleshooting guide

It isn't uncommon that you can't send emails despite the fact that you have configured your account name and password correctly in .env. This is because of increasingly stringent security measurements Gmail and other email providers put in place to fight spam emails.

📄️ Telegram Setup Guide

This is a community-contributed guide. This guide is based on certain Obico community members' own setup and hence may not work for you.

📄️ Pushover Notifications Setup Guide

This is a community-contributed guide. This guide is based on certain Obico community members' own setup and hence may not work for you.