Docker scripts for LinuxServer.io Docker containers

These scripts allow you to easily deploy LinuxServer.io Docker containers using predefined settings.

The scripts are automatically generated based on data from the LinuxServer.io GitHub repositories.

Please keep the following in mind:

• The templates are not supported by LinuxServer.io.
• The templates are generated automatically, so requests to add specific templates cannot be accepted.

Prerequisites

• A server with Docker installed

Install the scripts

Execute the following to install the scripts in /srv/lsio.

#!/bin/bash

URL="https://github.com/technorabilia/docker-bits/archive/refs/heads/main.zip"
DEST_DIR="/srv/lsio"
TMP_ZIP="$(mktemp)"

# Exit if destination already exists
if [ -d "$DEST_DIR" ]; then
    echo "Error: $DEST_DIR already exists. Exiting."
    exit 1
fi

# Create destination directory and set ownership
sudo mkdir -p "$DEST_DIR"
sudo chown -R $USER:$USER "$DEST_DIR"

# Download and unzip the archive
curl -sL "$URL" -o "$TMP_ZIP"
unzip -q "$TMP_ZIP" -d "$DEST_DIR"

# Move extracted lsio content to DEST_DIR
mv -f "$DEST_DIR/docker-bits-main/lsio/"* "$DEST_DIR/."

# Clean up
rm -rf "$DEST_DIR/docker-bits-main"
rm "$TMP_ZIP"

echo "Scripts extracted to $DEST_DIR."

After installing the scripts, navigate to the /srv/lsio directory:

cd /srv/lsio

You will find one file docker-env.cfg and multiple directories. Each directory represents a supported application.

docker-env.cfg

If needed, adjust the base directory for your volume host directories, Process User ID (PUID), Process Group ID (PGID), and timezone (TZ).

More information on PUID and PGID can be found here.

When modifying a variable, ensure you uncomment the line by removing the #.

If no values are set, the Docker scripts will fall back to the defaults shown below:

#BASEDIR=/volume1/docker
#PUID=1000
#PGID=1000
#TZ=Etc/UTC

Application list

All applications listed here are available as scripts.

How to use the scripts

As an example, we will look at the scripts for Sonarr.

After installing the scripts, change into the Sonarr directory:

cd /srv/lsio/sonarr

You will see three files:

run-once.sh
docker-compose.yaml
docker-run.sh

run-once.sh

The run-once.sh script links the general settings from docker-env.cfg and creates the required volume directories:

ln -s ../docker-env.cfg ./.env
. ./.env
mkdir -p ${BASEDIR:-/srv/lsio}/sonarr/config
mkdir -p ${BASEDIR:-/srv/lsio}/sonarr/tv `# [OPTIONAL]`
mkdir -p ${BASEDIR:-/srv/lsio}/sonarr/downloads `# [OPTIONAL]`

Run the script:

sh run-once.sh

As the name suggests, you only need to run this once. You can delete the script afterwards if you like.

docker-compose.yaml

You can use the docker-compose.yaml file with docker compose:

---
services:
  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    container_name: sonarr
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-Etc/UTC}
    volumes:
      - ${BASEDIR:-/srv/lsio}/sonarr/config:/config
      - ${BASEDIR:-/srv/lsio}/sonarr/tv:/tv
      - ${BASEDIR:-/srv/lsio}/sonarr/downloads:/downloads
    ports:
      - 8989:8989
    restart: unless-stopped

Start the Sonarr container:

docker compose up -d

Using docker compose is the recommended approach.

docker-run.sh

Alternatively, you can use docker run through the provided docker-run.sh script:

. ./.env
docker run -d \
  --name=sonarr \
  -e PUID=${PUID:-1000} \
  -e PGID=${PGID:-1000} \
  -e TZ=${TZ:-Etc/UTC} \
  -p 8989:8989 \
  -v ${BASEDIR:-/srv/lsio}/sonarr/config:/config \
  -v ${BASEDIR:-/srv/lsio}/sonarr/tv:/tv \
  -v ${BASEDIR:-/srv/lsio}/sonarr/downloads:/downloads \
  --restart unless-stopped \
  lscr.io/linuxserver/sonarr:latest

Start the container:

sh docker-run.sh

Example output

For docker compose:

$ cd /srv/lsio/sonarr
$ docker compose up -d 
[+] Running 2/2
 ✔ Network sonarr_default  Created                                                                                 0.0s 
 ✔ Container sonarr        Started                                                                                 0.1s 
$ docker compose down
[+] Running 2/2
 ✔ Container sonarr        Removed                                                                                 3.2s 
 ✔ Network sonarr_default  Removed                                                                                 0.1s 
$

For docker run:

$ cd /srv/lsio/sonarr
$ sh docker-run.sh
2d27e4520e57420c12742cbc152aa8bd849f82fcad6aa32bd77f1017f0e15f95
$ docker rm -f sonarr
sonarr
$

Report issues

If you encounter a problem, please report it on the project's GitHub Issues page. Issues will be reviewed as soon as possible.

Considerations

• With the default volume structure recommended by LinuxServer.io, you cannot use hard links. More information is available here.
• The scripts are updated daily.

Credits

A big thank you to LinuxServer.io for their outstanding work. Without their efforts, this project would not be possible.