### Install DockSTARTer

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Run the docker install script to set up necessary dependencies and Docker. This script updates the system, installs essential tools like curl, git, yq, docker, and docker-compose, and prompts for a reboot upon completion.

```bash
sudo ds -i
```

--------------------------------

### Install DockStarter on MacOS

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary command-line tools and DockStarter on MacOS. Requires a reboot after installation.

```bash
brew install bash curl git grep gnu-sed
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Install DockStarter on DNF Systems

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for systems using DNF package manager (e.g., Fedora). Requires a reboot after installation.

```bash
sudo dnf install curl git
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Install DockStarter on APT Systems

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for systems using APT package manager (e.g., Debian, Ubuntu). Requires a reboot after installation.

```bash
sudo apt-get install curl git
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Install DockStarter on Raspbian (APT)

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for Raspbian, including system updates and upgrades. Requires a reboot after installation.

```bash
sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get install curl git
bash -c "$(curl -fsSL https://get.docker.com)"
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Start Docker Service using vpnup.sh

Source: https://github.com/ghostwriters/dockstarter/wiki/VPN-Information

This script starts the Docker service. It checks if the system uses systemd (indicated by '/sbin/init' being a symlink) and uses the appropriate command ('systemctl start docker' or '/etc/init.d/docker start').

```bash
#!/bin/bash
if [[ -L "/sbin/init" ]]; then
    systemctl start docker
else
    /etc/init.d/docker start
fi
```

--------------------------------

### Copy Example Environment File

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Copies the example .env file to your user's configuration directory, creating it if it doesn't exist. This file serves as a template for your environment-specific settings.

```bash
cd ~/.docker/compose
cp .env.example .env
```

--------------------------------

### Install DockStarter on APK Systems

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for systems using APK package manager (e.g., Alpine Linux). Requires a reboot after installation.

```bash
sudo apk add curl git
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Start Plex Server with Dockstarter

Source: https://github.com/ghostwriters/dockstarter/wiki/Plex

Start the Plex Media Server using Dockstarter after configuring the claim token.

```bash
sudo ds -c up
```

--------------------------------

### Install DockStarter on Pacman Systems

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for systems using Pacman package manager (e.g., Arch, Manjaro). Requires a reboot after installation.

```bash
sudo pacman -Sy curl docker git
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Install resolvconf

Source: https://github.com/ghostwriters/dockstarter/wiki/Pi‐hole

Installs the resolvconf package on Ubuntu systems. This is a prerequisite for managing DNS configurations.

```bash
sudo apt install resolvconf
```

--------------------------------

### Alternative DockStarter Install (Any System)

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Provides an alternative method for installing DockStarter by cloning the repository and running the main script. This method is for users concerned about the security of the standard download method.

```bash
## NOTE: Run the appropriate command for your distro
sudo apt-get install curl git
sudo dnf install curl git
sudo pacman -Sy curl git
sudo yum install curl git
brew install bash curl git grep gnu-sed
```

```bash
git clone https://github.com/GhostWriters/DockStarter "/home/${USER}/.dockstarter"
bash /home/${USER}/.dockstarter/main.sh -vi
sudo reboot
```

--------------------------------

### Install DockStarter on YUM Systems

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs necessary packages and DockStarter for systems using YUM package manager (e.g., CentOS). Requires a reboot after installation.

```bash
sudo yum install curl git
bash -c "$(curl -fsSL https://get.dockstarter.com)"
sudo reboot
```

--------------------------------

### Run DockStarter

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Command to execute DockStarter after installation. This will launch the main menu for configuration and app selection.

```bash
ds
```

--------------------------------

### Install cifs-utils on Debian/Ubuntu

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Install the necessary package for mounting CIFS (SMB) shares on Debian-based Linux distributions.

```bash
sudo apt-get install cifs-utils
```

--------------------------------

### Install Docker on MacOS using Homebrew (Option 1)

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs Docker and Docker Compose on MacOS using Homebrew. This is one of two alternative methods for Homebrew installation.

```bash
brew update
brew upgrade --cask
brew upgrade
brew install --cask docker
brew install docker-compose
```

--------------------------------

### Install Docker on MacOS using Homebrew (Option 2)

Source: https://github.com/ghostwriters/dockstarter/blob/main/README.md

Installs Docker and Docker Compose on MacOS using Homebrew. This is an alternative method to the first Homebrew option.

```bash
brew update
brew upgrade --cask
brew upgrade
brew install docker docker-compose
```

--------------------------------

### Example of Download Directory Structure

Source: https://github.com/ghostwriters/dockstarter/wiki/Technical-Info

This output shows the directory structure of a download location on a Linux system. It illustrates the typical folders created by download clients, such as 'complete', 'incomplete', and 'watch'.

```bash
p2p@p2pmachine:/mnt/p2pDownloads$ ls -la
total 13496
drwxr-xr-x 14 p2p  p2p      4096 Jun 25 19:08 .
drwxr-xr-x  6 root root     4096 Jun 23 16:20 ..
drwxr-xr-x  3 p2p  p2p      4096 Jun 24 08:26 complete
drwxr-xr-x  5 p2p  p2p      4096 Jun 30 08:31 completed
drwxr-xr-x  2 p2p  p2p      4096 Jun 24 08:26 incoming
drwxr-xr-x  4 p2p  p2p      4096 Jun 30 19:53 incomplete
drwxr-xr-x  4 p2p  p2p      4096 Jun 30 14:03 intermediate
drwxr-xr-x  2 p2p  p2p     16384 Jun 23 15:32 lost+found
drwxr-xr-x  2 p2p  p2p      4096 Jun 30 14:04 nzb
-rw-r--r--  1 p2p  p2p  13726266 Jun 30 20:10 nzbget.log
drwxr-xr-x  2 p2p  p2p     20480 Jun 30 14:04 queue
drwxr-xr-x  2 p2p  p2p      4096 Jun 23 16:43 tmp
drwxr-xr-x  7 p2p  p2p      4096 Jun 30 19:53 transmission
drwxr-xr-x  2 p2p  p2p      4096 Jun 24 08:26 watch
drwxr-xr-x  2 p2p  p2p      4096 Jun 23 16:43 watched
p2p@p2pmachine:/mnt/p2pDownloads$
```

--------------------------------

### Disable Docker Auto-Start (Ubuntu)

Source: https://github.com/ghostwriters/dockstarter/wiki/VPN-Information

This command disables the Docker service from automatically starting on boot. This is useful if you want to manually control Docker's startup, for example, when using OpenVPN for all connections.

```bash
sudo systemctl disable docker
```

--------------------------------

### Max Backup App Stop/Start Sequence

Source: https://github.com/ghostwriters/dockstarter/wiki/Backups

Illustrates the process of stopping, backing up, and starting individual applications during a 'max' backup.

```text
Stop radarr
Backup radarr
Start radarr
Stop sonarr
Backup sonarr
Start sonarr
```

--------------------------------

### Scheduling Daily Backups with Cron

Source: https://github.com/ghostwriters/dockstarter/wiki/Backups

Provides examples of cron job entries for scheduling daily backups at 2 AM using DockSTARTer's command-line interface.

```bash
0 2 * * * /home/<USER>/.docker/main.sh -b min
```

```bash
0 2 * * * /home/<USER>/.docker/main.sh -b med
```

```bash
0 2 * * * /home/<USER>/.docker/main.sh -b max
```

--------------------------------

### Docker Compose YML Configuration Example

Source: https://github.com/ghostwriters/dockstarter/wiki/Technical-Info

This is an example of a Docker Compose YML file used by DockSTARTer. It defines services, images, container names, restart policies, environment variables, and volume mounts for a Sonarr container.

```yaml
version:             "3.6"
services:
  sonarr:
    image:           containers_author/sonarr
    container_name:  sonarr
    restart:         always
    environment:
      - PGID=${PGID} 
      - PUID=${PUID} 
      - TZ=${TZ} 
    volumes:
      - ${DOCKERCONFDIR}/sonarr:/config
      - ${DOWNLOADSDIR}:/downloads
      - ${MEDIADIR_TV}:/tv
```

--------------------------------

### Set Email and URL for LetsEncrypt

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Configure the LETSENCRYPT_EMAIL and LETSENCRYPT_URL variables in the .env file for your Let's Encrypt setup. Use your actual email and domain.

```bash
LETSENCRYPT_EMAIL=user@domain.com
LETSENCRYPT_URL=appropriateaddress.com
```

--------------------------------

### Copy Organizr Subfolder Configuration

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Copy the sample configuration file for Organizr's subfolder setup. This enables Organizr to be accessed via a subfolder path.

```bash
cp organizr.subfolder.conf.sample organizr.subfolder.conf
```

--------------------------------

### Backup Rotation Visualization

Source: https://github.com/ghostwriters/dockstarter/wiki/Backups

A visual representation of the backup rotation process, showing how older backups are rotated and eventually removed. This example illustrates up to 16 backup slots.

```text
1   1   1   1   1   1   1   1   1   1   1   1   1   1   1   1   1
2   2   2   2   2   2   2   2   2   2   2   2   2   2   2   2   2
    3       3       3       3       3       3       3       3
4       4       4       4       4       4       4       4       4
    5               5               5               5
        6               6               6               6
            7               7               7               7
8               8               8               8               8
    9                               9
        10                              10
            11                              11
                12                              12
                    13                              13
                        14                              14
                            15                              15
16                              16                              16
```

--------------------------------

### Disable Subdomains for Non-Subdomain Setup

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

If not using subdomains, blank out the LETSENCRYPT_SUBDOMAINS variable in the .env file. This ensures the configuration is set up for subfolder access.

```bash
LETSENCRYPT_SUBDOMAINS=
```

--------------------------------

### DockSTARTer Backup Levels

Source: https://github.com/ghostwriters/dockstarter/wiki/Backups

Explains the scope of backups for min, med, and max levels. Min backs up the .env file. Med backs up .env and enabled app configs. Max backs up all config folders, stopping and starting apps as needed.

```text
Min: Backs up your .env file
Med: Backs up your .env file and the config folder for any enabled app
Max: Backs up your .env file and any config folder found in your DOCKERCONFDIR. Apps will be stopped before running a backup and started after completing a backup.
```

--------------------------------

### Combine Watchtower Overrides with Existing Service Overrides

Source: https://github.com/ghostwriters/dockstarter/wiki/Watchtower

This example shows how to merge Watchtower notification configurations with existing overrides for other services like netdata in your docker-compose.override.yml.

```yaml
version: "3.4" # this must match the version in docker-compose.yml
services:
  netdata:
    hostname: newhostname
  watchtower:
    environment:
      - WATCHTOWER_NOTIFICATIONS=slack
      - WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL=https://url.discord.com/slack
      - WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server-1
```

--------------------------------

### Modify Service Image and Add Volume with Override

Source: https://github.com/ghostwriters/dockstarter/wiki/Overrides

This example demonstrates how to change the Docker image for a service (Sonarr) and add a new volume mount using a `docker-compose.override.yml` file. Ensure the `version` matches the main `docker-compose.yml`.

```yaml
version: "3.4"  # this must match the version in docker-compose.yml
services:
  sonarr:
    image: hotio/suitarr:sonarr
    volumes:
      - ${MEDIADIR_TV}:/media
```

--------------------------------

### Generate Docker Compose Configuration

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

This script verifies dependencies, installs or updates them if necessary, and creates the docker-compose.yml file based on your .env configuration. It will then prompt to run your selected containers.

```bash
sudo ds -c
```

--------------------------------

### Uninstall Docker Compose via Pip

Source: https://github.com/ghostwriters/dockstarter/wiki/Uninstallation-of-DS-or-Applications-specifically

Use this command to uninstall Docker Compose if it was installed using pip. Ensure you have the necessary permissions.

```bash
sudo pip uninstall docker-compose
```

--------------------------------

### Get User ID

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Retrieves the User ID (PUID) of the current user. This is required for setting file permissions within Docker containers.

```bash
id -u ${USER}
```

--------------------------------

### Get Group ID

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Retrieves the Group ID (PGID) of the current user. This is required for setting file permissions within Docker containers.

```bash
id -g ${USER}
```

--------------------------------

### Linux SMB Credentials File

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Create a credentials file for mounting SMB shares. This file should contain the username and password for accessing the resource.

```bash
username=<username to access resource>
password=<password to access resource>
```

--------------------------------

### Mount SMB Share on Windows

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Map an SMB/Windows share as a network drive on a Windows host using the 'net use' command.

```cmd
net use Z: \host\Downloads
```

--------------------------------

### Copy Portainer Subfolder Proxy Configuration

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Use this command to enable Portainer to be accessible via a subfolder (e.g., domain.com/portainer). Ensure the .sample extension is removed from the configuration file.

```bash
cp ~/.docker/config/letsencrypt/nginx/proxy-confs/portainer.subfolder.conf.sample ~/.docker/config/letsencrypt/nginx/proxy-confs/portainer.subfolder.conf
```

--------------------------------

### Backup Plex Configuration Directory

Source: https://github.com/ghostwriters/dockstarter/wiki/Plex

Back up the Plex configuration directory before making changes.

```bash
mv ~/.docker/config/plex/ ~/.docker/config/plex.bak/
```

--------------------------------

### Copy Portainer Subdomain Proxy Configuration

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Use this command to enable Portainer to be accessible via a subdomain (e.g., portainer.domain.com). Ensure the .sample extension is removed from the configuration file.

```bash
cp ~/.docker/config/letsencrypt/nginx/proxy-confs/portainer.subdomain.conf.sample ~/.docker/config/letsencrypt/nginx/proxy-confs/portainer.subdomain.conf
```

--------------------------------

### Configure resolvconf head

Source: https://github.com/ghostwriters/dockstarter/wiki/Pi‐hole

Sets the primary nameserver for resolvconf to use. This ensures that DNS queries are directed to the specified server.

```bash
sudo service resolvconf restart
```

--------------------------------

### Add SMB Mount to /etc/fstab

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Configure a persistent SMB share mount by adding an entry to the /etc/fstab file. This ensures the share is mounted automatically upon system reboot.

```bash
//<host>/Downloads /mnt/downloads cifs uid=1000,gid=1000,credentials=/home/<your home user>/.mount-creds,rw,vers=3.0
```

--------------------------------

### Mount SMB Share on Linux

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Mount an SMB/Windows share to a local directory on a Linux system. Ensure you replace placeholders with your actual host, share name, mount point, and credentials file path.

```bash
sudo mount -t cifs //<host>/Downloads /mnt/downloads -o uid=1000,gid=1000,credentials=/home/<your home user>/.credentials,rw,vers=3.0
```

--------------------------------

### Configure Plex Claim Token in .env

Source: https://github.com/ghostwriters/dockstarter/wiki/Plex

Edit the .env file to set the PLEX_CLAIM environment variable with your generated Plex claim token.

```bash
PLEX_CLAIM=
```

--------------------------------

### Configure Plex Host Network Mode

Source: https://github.com/ghostwriters/dockstarter/wiki/Plex

Temporarily set PLEX_NETWORK_MODE to 'host' in the .env file for initial server claiming if direct access fails. Remember to reset it after claiming.

```bash
PLEX_NETWORK_MODE=host
```

--------------------------------

### Restart AirDC++ Docker Container

Source: https://github.com/ghostwriters/dockstarter/wiki/AirDCpp

After successfully configuring the user and password via the `--add-user` command, restart the AirDC++ container to apply the new configuration.

```bash
docker start airdcpp
```

--------------------------------

### Configure VPN tun Driver and iptables

Source: https://github.com/ghostwriters/dockstarter/wiki/VPN-Information

These commands adjust the host system to load the 'iptable_mangle' and 'tun' modules, which are required by VPN containers. A reboot is necessary after applying these changes.

```bash
echo "iptable_mangle" | sudo tee /etc/modules-load.d/iptable_mangle.conf
echo "tun" | sudo tee /etc/modules-load.d/tun.conf
sudo reboot
```

--------------------------------

### Clean DockSTARTer Images

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Use this command to prune and clean up any previous images left over by DockSTARTer. This helps recover disk space.

```bash
sudo ds -p
```

--------------------------------

### Stop and Reconfigure AirDC++ Docker Container

Source: https://github.com/ghostwriters/dockstarter/wiki/AirDCpp

Use these commands to stop the running AirDC++ container and initiate the configuration process, which includes adding a user. This is necessary when the initial configuration is missing.

```bash
docker stop airdcpp
docker run --rm -it --volumes-from airdcpp gangefors/airdcpp-webclient --add-user
```

--------------------------------

### Regenerate DockSTARTer Configurations

Source: https://github.com/ghostwriters/dockstarter/wiki/VPN-Information

Navigate to the DockSTARTer compose directory and run the generator command. This is necessary after making changes to the .env file or if Docker was stopped and needs to be restarted.

```bash
cd ~/.docker/compose
sudo ds -c
```

--------------------------------

### Configure localhost name resolution

Source: https://github.com/ghostwriters/dockstarter/wiki/Pi‐hole

Sets up name resolution for localhost and custom domains in the hosts file. This is often required for local services and testing.

```bash
127.0.0.1    machinename.localhost    machinename
127.0.0.1    domain.com
```

--------------------------------

### Configure Slack/Discord Notifications for Watchtower

Source: https://github.com/ghostwriters/dockstarter/wiki/Watchtower

Use this snippet to set up Slack or Discord notifications for Watchtower. Ensure the hook URL and identifier are correctly configured.

```yaml
watchtower:
  environment:
    - WATCHTOWER_NOTIFICATIONS=slack
    - WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL=https://url.discord.com/slack
    - WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server-1
```

--------------------------------

### Restart LetsEncrypt Container

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Restart the LetsEncrypt container after making changes to proxy configuration files to apply the updates.

```bash
docker restart letsencrypt
```

--------------------------------

### Redirect Main Index.html to Organizr

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Replace the default index.html with a PHP file that redirects to your Organizr instance. This makes the main domain URL load Organizr directly.

```php
<?php header("Location: https://organizr.mydomain.duckdns.org"); ?>
```

--------------------------------

### Edit NextCloud Config File

Source: https://github.com/ghostwriters/dockstarter/wiki/NextCloud

Use this command to open the NextCloud config.php file for editing. Add the 'overwritehost' directive as shown to resolve issues with apps when behind a reverse proxy.

```bash
nano /config/www/nextcloud/config/config.php
```

```php
'overwritehost' => 'hostname',
```

--------------------------------

### Enable Web IP Check in DDClient Config

Source: https://github.com/ghostwriters/dockstarter/wiki/ddclient

Uncomment this line in the DDClient configuration file to enable checking your IP address via a web service. This is often a prerequisite for dynamic DNS updates.

```ini
use=web, web=checkip.dyndns.org/, web-skip='IP Address' # found after IP Address
```

--------------------------------

### Stop and Remove Plex Container

Source: https://github.com/ghostwriters/dockstarter/wiki/Plex

Use these commands to stop and remove the existing Plex Docker container before re-setup.

```bash
docker stop plex && docker rm plex
```

--------------------------------

### Stop Docker Service using vpnDown.sh

Source: https://github.com/ghostwriters/dockstarter/wiki/VPN-Information

This script stops the Docker service. It checks if the system uses systemd (indicated by '/sbin/init' being a symlink) and uses the appropriate command ('systemctl stop docker' or '/etc/init.d/docker stop').

```bash
#!/bin/bash
if [[ -L "/sbin/init" ]]; then
    systemctl stop docker
else
    /etc/init.d/docker stop
fi
```

--------------------------------

### Update DockSTARTer

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Fetches the latest changes for DockSTARTer. After updating the core DockSTARTer files, ensure your .env file is also updated.

```bash
sudo ds -u
```

--------------------------------

### Logarr Configuration Paths

Source: https://github.com/ghostwriters/dockstarter/wiki/Logarr

Edit these lines in config.php to set the correct log file paths for Sonarr and Radarr within Logarr.

```php
"Sonarr" => '/var/log/logarrlogs//sonarr/logs/sonarr.txt',

    "Radarr" => '/var/log/logarrlogs/radarr/logs/radarr.txt',
```

--------------------------------

### Check Application Using a Specific Port

Source: https://github.com/ghostwriters/dockstarter/wiki/Frequently-Asked-Questions

Use this command to identify which application is currently using a specific network port. This is helpful for diagnosing 'address already in use' errors.

```bash
sudo lsof -i :<myport>
```

```bash
sudo lsof -i :5353
```

--------------------------------

### Enable HTTP to HTTPS Redirect

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

Uncomment the server block to redirect all HTTP traffic to HTTPS. This ensures secure connections for all users accessing the domain.

```nginx
# listening on port 80 disabled by default, remove the "#" signs to enable
# redirect all traffic to https
server {
	listen 80;
	listen [::]:80;
	server_name _;
	return 301 https://$host$request_uri;
}
```

--------------------------------

### Netdata Raspberry Pi CPU Temperature Monitoring

Source: https://github.com/ghostwriters/dockstarter/wiki/Netdata

Enables the collection of CPU temperature data for Raspberry Pi within Netdata by forcing sensor detection.

```ini
sensors=force
```

--------------------------------

### Update DockSTARTer Environment File

Source: https://github.com/ghostwriters/dockstarter/wiki/Advanced-Usage

Updates the .env file to reflect any new variables or changes introduced in the latest DockSTARTer version. This is typically run after updating DockSTARTer itself.

```bash
sudo ds -e
```

--------------------------------

### Netdata Service Monitoring with httpcheck Plugin

Source: https://github.com/ghostwriters/dockstarter/wiki/Netdata

Configures the httpcheck plugin for Netdata to monitor services like Hydra and Ombi. It specifies URLs, timeouts, accepted status codes, and regular expressions for matching responses. Ensure to replace placeholder IPs and ports with your actual network details.

```yaml
# This plugin is intended for simple cases. Currently, the accuracy of the response time is low and should be used as reference only.

Hydra:
    url: 'http://192.168.86.60:5076/nzbhydra/'
    timeout: 1
    redirect: no
    status_accepted:
        - 200
    regex: '.*hydra.*'

Ombi:
    url: 'http://192.168.86.60:3579/ombi/landingpage'
    timeout: 1
    redirect: yes
    status_accepted:
        - 200
    regex: '.*ombi.*'
```

--------------------------------

### Stop and disable systemd-resolved service

Source: https://github.com/ghostwriters/dockstarter/wiki/Pi‐hole

Stops and disables the systemd-resolved service entirely. Use this only if the DNSStubListener method does not resolve the conflict.

```bash
sudo systemctl stop systemd-resolv.service
sudo systemctl disable systemd-resolv.service
```

--------------------------------

### Configure Email Notifications for Watchtower

Source: https://github.com/ghostwriters/dockstarter/wiki/Watchtower

Configure Watchtower to send email notifications. This requires setting up sender and receiver details, SMTP server information, and authentication credentials.

```yaml
watchtower:
  environment:
    - WATCHTOWER_NOTIFICATION_EMAIL_FROM=myemail@gmail.com
    - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=secretPassword
    - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PORT=587
    - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=myemail@gmail.com
    - WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.gmail.com
    - WATCHTOWER_NOTIFICATION_EMAIL_TO=myemail@gmail.com
    - WATCHTOWER_NOTIFICATIONS=email
```

--------------------------------

### Identify Service Occupying a Port

Source: https://github.com/ghostwriters/dockstarter/wiki/Port-Conflicts

Use this command to find which process is currently using a specific port. Replace '<port>' with the port number causing the conflict.

```bash
sudo netstat -ltunp | grep -w ':<port>'
```

--------------------------------

### Removing Immutable Attribute from Backups

Source: https://github.com/ghostwriters/dockstarter/wiki/Backups

Demonstrates the command to remove the immutable attribute from backup files or folders, which is necessary for manual deletion.

```bash
sudo chattr -R -i /path/to/backup/<appname>.###
```

--------------------------------

### Nginx Reverse Proxy Configuration for Netdata

Source: https://github.com/ghostwriters/dockstarter/wiki/Netdata

This Nginx configuration allows access to Netdata through a specific location, proxying requests to the Netdata container. It includes settings for host headers, connection handling, and gzip compression.

```nginx
location = /netdata {
	return 301 /netdata/;
}

location ~ /netdata/(?<ndpath>.*) {
	include /config/nginx/proxy.conf;
	resolver 127.0.0.11 valid=30s;
	proxy_redirect off;
	proxy_set_header Host $host;
	proxy_set_header X-Forwarded-Host $host;
	proxy_set_header X-Forwarded-Server $host;
	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	proxy_pass_request_headers on;
	proxy_set_header Connection "keep-alive";
	proxy_store off;
	proxy_pass http://netdata:19999/$ndpath$is_args$args;
	proxy_headers_hash_max_size 512;
	proxy_headers_hash_bucket_size 64;
	gzip on;
	gzip_proxied any;
	gzip_types *;
}
```

--------------------------------

### Remove Conflicting Package (avahi-daemon)

Source: https://github.com/ghostwriters/dockstarter/wiki/Port-Conflicts

If avahi-daemon is identified as the cause of a port conflict and is not needed, it can be removed using this command. This frees up the port for Docker services.

```bash
apt remove avahi-daemon
```

--------------------------------

### Disable systemd-resolved DNSStubListener

Source: https://github.com/ghostwriters/dockstarter/wiki/Pi‐hole

Disables the DNS stub listener for systemd-resolved to prevent conflicts on port 53. This is the recommended first step to resolve DNS conflicts.

```bash
sudo systemctl restart systemd-resolved
```

--------------------------------

### Comment Out Default Location Block

Source: https://github.com/ghostwriters/dockstarter/wiki/Let's-Encrypt-(Certbot)

When not using subdomains, comment out the default location block in the Nginx site configuration to prevent conflicts and ensure proper routing.

```nginx
#       location / {
#               try_files $uri $uri/ /index.html /index.php?$args =404;
#       }
```

--------------------------------

### Configure Sonarr Port in .env

Source: https://github.com/ghostwriters/dockstarter/wiki/Technical-Info

Modify the SONARR_PORT_8989 environment variable in your .env file to change the external port for Sonarr. This allows access to Sonarr via the new port, e.g., http://app.address:6969.

```env
SONARR_PORT_8989=6969
```

--------------------------------

### Disable OpLocks for SMB on Windows Registry

Source: https://github.com/ghostwriters/dockstarter/wiki/SMB-Mounting

Modify the Windows Registry to disable opportunistic locks (OpLocks) for SMB shares. This can resolve issues where containers lock and fail to unlock drives.

```powershell
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\mrxsmb
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\mrxsmb20
EnableOplocks REG_DWORD 0
```

--------------------------------

### Modify DelugeVPN Upstream Variable

Source: https://github.com/ghostwriters/dockstarter/wiki/DelugeVPN

Change the upstream variable in your DelugeVPN Nginx configuration file to 'delugevpn' to ensure correct routing for remote access.

```nginx
   set $upstream_deluge deluge;
```

```nginx
   set $upstream_deluge delugevpn;
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.