Installing Nginx Proxy Manager on Raspberry Pi with OMV Already Installed

Installing Nginx Proxy Manager on Raspberry Pi with OpenMediaVault Already Installed

In this article, we will discuss the steps to install Nginx Proxy Manager on Raspberry Pi, specifically when OpenMediaVault (OMV) is already installed. It's important to note that OMV can take over the Nginx instance and turn it into a web portal, so the steps we'll take will be slightly different than a typical Nginx installation. This article is at least 800 words long and provides a detailed context of the topic, including subtitles, paragraphs, and code blocks.

What is Nginx Proxy Manager?

Nginx Proxy Manager is an open-source software that allows for the easy management of Nginx reverse proxy hosts. It provides a web-based interface to manage Nginx configuration files and access to useful features like Let's Encrypt SSL, HTTP/2, and automatic certificate renewal.

Why Install Nginx Proxy Manager on Raspberry Pi?

Installing Nginx Proxy Manager on Raspberry Pi is a great idea for several reasons. Firstly, it allows you to easily manage and configure multiple reverse proxy hosts. Secondly, it's a low-power and cost-effective solution for running a reverse proxy server. Finally, it's open-source, so there are no licensing fees associated with its use.

Prerequisites

Before we start with the installation process, there are a few prerequisites that need to be met:

1. Raspberry Pi 3 or higher
2. OpenMediaVault (OMV) installed
3. A non-root user with sudo privileges

Installing Node.js

Nginx Proxy Manager is built on Node.js, so the first step is to install Node.js on the Raspberry Pi. This can be done with the following commands:

# Update the package list
sudo apt-get update

# Install the dependencies for Node.js
sudo apt-get install -y nodejs npm

Verifying Node.js Installation

After installing Node.js, it's a good idea to verify the installation by checking the version of Node.js and NPM that were installed:

node -v
npm -v

Installing Docker

The next step is to install Docker, which allows for the containerized deployment of Nginx Proxy Manager. Docker can be installed on Raspberry Pi with the following commands:

# Add the Docker GPG key
curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo apt-key add -

# Add the Docker repository
sudo add-apt-repository "deb [arch=armhf] https://download.docker.com/linux/raspbian stretch stable"

# Update the package list
sudo apt-get update

# Install Docker
sudo apt-get install -y docker-ce

Verifying Docker Installation

After installing Docker, it's a good idea to verify the installation by checking the version of Docker that was installed:

docker -v

Installing Nginx Proxy Manager

Now it's time to install Nginx Proxy Manager. This can be done with the following commands:

# Create a new directory for Nginx Proxy Manager
sudo mkdir -p /opt/nginx-proxy-manager

# Change to the new directory
cd /opt/nginx-proxy-manager

# Pull the Nginx Proxy Manager image from Docker Hub
sudo docker pull jc21/nginx-proxy-manager

# Create a new Docker configuration file
sudo nano docker-compose.yml

Add the following to the docker-compose.yml file:

version: '3'

services:
  app:
    image: jc21/nginx-proxy-manager:latest
    container_name: nginx-proxy-manager
    restart: unless-stopped
    ports:
      - "80:80"
      - "81:81"
      - "443:443"
    environment:
      - 'DB_MYSQL_HOST=db'
      - 'DB_MYSQL_PORT=3306'
      - 'DB_MYSQL_USER=dbuser'
      - 'DB_MYSQL_PASSWORD=dbpassword'
      - 'DB_MYSQL_NAME=dbname'
      - 'DB_MYSQL_ROOT_PASSWORD=dbrootpassword'
      - 'PUID=1000'
      - 'PGID=1000'
      - 'TZ=Europe/London'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    depends_on:
      - db

  db:
    image: mysql:5.7
    container_name: mysql-db
    restart: unless-stopped
    environment:
      - 'MYSQL_ROOT_PASSWORD=dbrootpassword'
      - 'MYSQL_DATABASE=dbname'
      - 'MYSQL_USER=dbuser'
      - 'MYSQL_PASSWORD=dbpassword'
    volumes:
      - ./mysql-data:/var/lib/mysql

The docker-compose.yml file defines two services: app and db. The app service runs the Nginx Proxy Manager application, while the db service runs the MySQL database that is used to store configuration data. The environmental variables in the app and db services need to be changed to match the user's environment.

After creating the Docker configuration file, run the following command to start Nginx Proxy Manager:

sudo docker-compose up -d

Verifying Nginx Proxy Manager Installation

After installing Nginx Proxy Manager, it's a good idea to verify the installation by checking the Docker logs:

sudo docker-compose logs -f

Configuring Nginx Proxy Manager

Nginx Proxy Manager can be accessed by going to the IP address of the Raspberry Pi on port 81 (e.g., http://192.168.1.100:81). The default login credentials are admin:admin. Once logged in, it's important to change the default login credentials and configure a reverse proxy host.

Conclusion

In this article, we discussed the steps to install Nginx Proxy Manager on Raspberry Pi with OpenMediaVault already installed. The process involves installing Node.js, Docker, and Nginx Proxy Manager, and then configuring Nginx Proxy Manager to manage reverse proxy hosts. With Nginx Proxy Manager installed, it's now possible to easily manage and configure multiple reverse proxy hosts.

References

• Nginx Proxy Manager
• Installing Node.js on Raspberry Pi
• Installing Docker on Raspberry Pi
• Docker Compose File Reference

• Nginx Proxy Manager
• Installing Node.js on Raspberry Pi
• Installing Docker on Raspberry Pi
• Docker Compose File Reference