Self-host 1/16: Homarr

In this series, you will learn how to self-host 16 services on your server. To self-host a service, you can either use a server at home or a server in the cloud.

Nginx Proxy Manager

The first thing you need to set up is a reverse proxy, so you can go to a domain or subdomain to access the service.

Install docker-compose

Update your package list

sudo apt-get update

Install dependencies

sudo apt-get install ca-certificates curl gnupg lsb-release

Add Docker’s official GPG key

sudo apt-get install ca-certificates curl gnupg lsb-release

Set up the stable repository

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Update your package list

sudo apt-get update

Install Docker Engine

sudo apt-get install docker-ce docker-ce-cli containerd.io

Verify that Docker Engine is installed correctly

sudo docker run hello-world

Download the current stable release of Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep tag_name | cut -d '"' -f 4)/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Apply executable permissions to the binary

sudo chmod +x /usr/local/bin/docker-compose

Verify the installation

docker-compose --version

Create directory

Create a directory

Change “name-of-the-service” with the actual name of the container

mkdir -p ~/docker-compose/name-of-the-service

Move into the directory

Change “name-of-the-service” with the name you choose above

cd ~/docker-compose/name-of-the-service

Create a docker-compose.yml file

Create a docker-compose.yml file

nano docker-compose.yml

Past this content into the file

version: '3.8'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '81:81'
      - '443:443'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

Press “ctrl + o” to save the file

Press “ctrl + x” to exit the file

Start the docker-compose container

Start the docker-compose container

sudo docker-compose up -d

Access the service

To access the service, open a browser and type in the following content

http://<your-server-ip>:81

Afterwards, you will be presented by a Nginx Proxy Manager website. Login with this credentials
Email: [email protected]
Password: changeme

Homarr

Create directory

Create a directory

Change “name-of-the-service” with the actual name of the container

mkdir -p ~/docker-compose/name-of-the-service

Move into the directory

Change “name-of-the-service” with the name you choose above

cd ~/docker-compose/name-of-the-service

Create a docker-compose.yml file

Create a docker-compose.yml file

nano docker-compose.yml

Past this content into the file

version: '3'
#---------------------------------------------------------------------#
#     Homarr - A simple, yet powerful dashboard for your server.     #
#---------------------------------------------------------------------#
services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # Optional, only if you want docker integration
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
      - ./homarr/data:/data
    ports:
      - '20001:7575'

Press “ctrl + o” to save the file

Press “ctrl + x” to exit the file

Start the docker-compose container

Start the docker-compose container

sudo docker-compose up -d

Access the service

To access the service, open a browser and type in the following content

http://<your-server-ip>:20001

Afterwards, you will be presented by the website. Now you can create an account and start using it.

Make the service available via a domain

Login into your Nginx Proxy Manager

Add a host

Click on “Proxy Hosts”

Click on “Add Proxy Host”

Fill in the details

Details

Domain Names: Enter your domain name (e.g. servicename.yourdomain.com)

Scheme: select “http”

Forward Host / IP: Enter the IP address of your server (enter “localhost” or “127.0.0.1” if its on the same machine)

Forward Port: Enter used port in the config

Cache Assets: Optional, check if needed

Block Common Exploits: Optional, check if needed (recommended)

Websockets Support: Check if your service needs Websocket support

Custom locations

Add location: Optional, check if needed

SSL

SSL Certificate: Select “Request a new SSL Certificate”

Force SSL: Optional, highly recommended automatic redirecting to HTTPS

HSTS Enabled: Optional, check if needed

Use a DNS Challenge: Optional, check if needed

HTTP/2 Support: Optional, check if needed

HSTS Subdomains: Optional, check if needed

Email Address for Let’s Encrypt: Enter your Email address

Agree to the Terms of Services

Advanced

Custom Nginx Configuration: Optional, check if needed

Click “Save”

Enjoy!

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top