deleted by creator

I think it will be easier to use docker compose with a premade docker compose file.

Create a new directory cd into it and then nano docker-compose.yaml. For instance, here is a docker compose I found one the audio bookshelf website:

version: "3.7"
  services: 
    audiobookshelf:
      image: ghcr.io/advplyr/audiobookshelf:latest
      ports: - 13378:80
      volumes:
        - </path/to/audiobooks>:/audiobooks
        - </path/to/podcasts>:/podcasts - </path/to/config>:/config
        - </path/to/metadata>:/metadata

https://www.audiobookshelf.org/docs/#docker-compose-install

I remember being so lost in the dark when starting docker. There’s 2 main approaches to launching docker containers. One is with CLI arguments and one is from a docker-compose.yml file.

I highly recommend the latter.

Try going to chatGPT and ask it to write a docker compose file for whatever service you’re trying to stand up.

Docker can be really confusing, but IMO being able to add and remove software without having changes made throughout your system is well worth the effort.

Docker’s hard. I never really got my head around it. I used “Swizzin Community Edition” to setup my media server. It was really easy compared to Docker-based solutions.

Been there, now I have over 12 containers running h24 on an old spare laptop with everything exposed via traefik (reverse proxy), self-signed CA, local DNS… what a ride ^^'.

The best advice and thats what helped me to get going, is to look/follow some youtube videos about docker and how to expose your first container locally, so you get the general gist on how it works.

2 years ago, NetworkChuck introduced me to docker container. Not saying he’s the best youtuber to get you into docker and learning and stuff, but it’s a GOOD starting point :).

There is also Christian Lempa, Tech world with nana, who also will you give you some good pointer with docker and docker compose.

Good luck !

Man, good luck. Is there no other way you can accomplish that without Docker. I’ve been using Linux for years and I still don’t know how to set up a docker container lol

Is there a Linux for people who are deeply entrenched in how Windows works

How Windows works is different I think?

I’m not above googling command lines that I can copy and paste but I’ve spent HOURS trying to figure this out and have gotten no where…

You don’t need.

I heard you are using a debian-based distro, can you read the man pages for apt?

Then use apt to find docker, and get it.

Once it’s installed in the terminal, how the hell do I find docker so I can start playing with it?

It is not installed in the terminal. It is installed on the system, ON DISK!

docker should be installed on /usr/bin. It is on PATH. Type docker and see what happen. If not, try searching on /usr/bin (on BSDs third party software are separated from base, so docker should be installed on /usr/local/bin)

And the docker service should be started, if not. Use the fucking systemctl to start it. The service name should be docker, if I recall correctly

Once it’s installed in the terminal, how the hell do I find docker so I can start playing with it?

Type docker in the terminal, it’s a CLI application.

But it sounds like you might want to install Docker Desktop, which does give you a GUI to use.

Linux is a slightly different way of thinking. There are any number of ways that you can solve any problem you have. In Windows there are usually only one or two that work. This is largely a result of the hacker mentality from which linux and Unix came from. “If you don’t like how it works, rewrite it your way” and “Read the F***ing Manual” were frequent refrains when I started playing with linux.

Mint is a fine distro which is based off of Ubuntu, if I remember correctly. Most documentation that applies to Ubuntu will also apply to you.

Not sure what exactly you installed, but I’m guessing that you did something along the lines of sudo apt-get install docker.

If you did that without doing anything ahead of time, what you probably got was a slightly out of date version of docker only from Mint’s repositories. Follow the instructions here to uninstall whatever you installed and install docker from docker’s own repositories.

The Docker Desktop that you may be used to from Windows is available for linux, however it is not part of the default install usually. You might look at this documentation.

I don’t use it, as I prefer ctop combined with docker-compose.

Towards that end, here is my docker-compose.yaml for my instance of Audiobookshelf. I have it connected to my Tailscale tailnet, but if you comment out the tailscale service stuff and uncomment the port section in the audiobookshelf service, you can run it directly. Assuming your not making any changes,

Create a directory somewhere,

mkdir ~/docker

mkdir ~/docker/audiobookshelf

This creates a directory in your home directory called docker and then a directory within that one called audiobookshelf. Now we want to enter that directory.

cd ~/docker/audiobookshelf

Then create your docker compose file

touch docker-compose.yaml

You can edit this file with whatever text editor you like, but I prefer micro which you may not have installed.

micro docker-compose.yaml

and then paste the contents into the file and change whatever setting you need to for your system. At a minimum you will need to change the volumes section so that the podcast and audiobook paths point to the correct location on your system. it follows the format <system path>:<container path>.

Once you’ve made all the needed changes, save and exit the editor and start the the instance by typing

sudo docker compose up -d

Now, add the service directly to your tailnet by opening a shell in the tailscale container

sudo docker exec -it audiobookshelf-tailscale /bin/sh

and then typing

tailscale up

copy the link it gives you into your browser to authenticate the instance. Assuming that neither you or I made any typos you should now be able to access audiobookshelf from http://books If you chose to comment out all the tailscale stuff you would find it at http://localhost:13378

docker-compose.yaml

version: "3.7"
services:
  tailscale:
    container_name: audiobookshelf-tailscale
    hostname: books                         # This will become the tailscale device name
    image: ghcr.io/tailscale/tailscale:latest
    volumes:
      - "./tailscale_var_lib:/var/lib"        # State data will be stored in this directory
      - "/dev/net/tun:/dev/net/tun"           # Required for tailscale to work
    cap_add:                                    # Required for tailscale to work
      - net_admin
      - sys_module
    command: tailscaled
    restart: unless-stopped
  audiobookshelf:
    container_name: audiobookshelf
    image: ghcr.io/advplyr/audiobookshelf:latest
    restart: unless-stopped
#    ports:                                                                  # Not needed due to tailscale
#      - 13378:80                                                                                                     
    volumes:
      - '/mnt/nas/old_media_server/media/books/Audio Books:/audiobooks'       # This line has quotes because there is a space that needed to be escaped.
      - /mnt/nas/old_media_server/media/podcasts:/podcasts                               # See, no quotes needed here, better to have them though.
      - /opt/audiobookshelf/config:/config                                       # I store my docker services in the /opt directory. You may want to change this to './config' and './metadata' while your playing around
      - /opt/audiobookshelf/metadata:/metadata
    network_mode: service:tailscale                                  # This line tells the audiobookshelf container to send all traffic to tailscale container

I’ve left my docker-compose file as-is so you can see how it works in my setup.

Apt install docker.io

docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Go to IP:8000 and now you can build docker compose stacks. A far easier way to learn docker.

Docker is one of the container technologies

Containers vs Images

This is a very simplified explanation, which hopefully clears up for you. As with all simplifications, they aren’t entirely correct.

Containers put processes, files, and networking into a space where they are secluded from the rest. You main OS is called the host and the container is called the guest. You can selectively share resources with the guest. To use an analogy, if you house were the computer with linux, if you took a room, put tools and resources for those tools into it, put workers into it, got them to start working and locked the door, they’d be contained in the room, unable to break out. If you want to give workers access to resources, you either a window, a corridor, or even a door depending on much access you want to give them.

Containers are created from an image. Think of it as the tools, resources, and configuration required every time you create a room in your house for workers to do a job. The woodworkers will need different tools and resources than say metalworkers.

Most images are stored on DockerHub. So when you do docker pull linuxserver/sonarr you download the image. When you do docker run linuxserver/sonarr you create a container from an image.

Installation

You’re on Cinnamon Mint which is linux distribution derived from another linux distribution called debian. You have to follow the installation instructions. Everything is there. If something doesn’t work, it’s most likely because you skipped a step. The most important ones are the post-installation steps:

• Adding your user to the docker group
• Logging out and back in (or simply restarting)

Those are the most commonly missed steps. I’ve fallen for this trap too!

Local help

To use linux, you need to learn about ways to help yourself or find help. On linux, most well-written programs print a help. Simply running the command without any arguments most often output a help text --> running docker does so. If they don’t, then the --help flag often does --> docker --help. The shorthand is -h --> docker -h.

Some commands have sub commands e.g docker run, docker image, docker ps, … . Those subcommands also take flags of which -h and --help are available.

The help output is often not extensive and programs often have a manual. To access it the command is man --> man find will output the manual for the find command. Docker doesn’t have a local manual but an online one.

For clarification when running a command there are different ways to interpret the text after the command:

Flags/Options

These are named parameters to the command. Some do not take input like -h and --help which are called flags. Some do like --file /etc/passwd and are often called options.

Arguments

These are unnamed parameters and each command interprets them differently. echo "hello world" --> echo is the command and "hello world" is the argument. Some commands can take multiple arguments

Running containers

Imperatively

As described above docker run linuxserver/sonarr runs an image in a container. However, it runs in the foreground (as opposed to the background in what is most often called a “daemon”). Starting in the foreground is most likely not how you want to run things as that means if you close your terminal, you end the process too. To run something in the background, you use docker run --detatch linuxserver/sonarr.

You can pass options like -v or --volume to make a file or folder from your host system available in the guest e.g -v /path/on/host:/tmp/path/in/guest. Or -p / --port to forward a host port to a guest port e.g -p 8080:80. That means if you access port 8080 on your host, the traffic will be forwarded to port 80 in the guest.

These are imperatives as in you command the computer to do a specific action. Run that docker image, stop that docker container, restart these containers, start a container with this port forward and that volume with this user …

Declaratively

If you don’t want to keep typing the same commands, you can declare everything about your containers up front. Their volumes, ports, environment variables, which image is used, which network card/interface they have access to, which other network they share with other containers, and so on.

This is done with docker-compose or docker compose for newer docker versions (not all operating systems have the new docker version).

This already a long text, so if you want to know more, the best resource is the docker compose manual and the compose file reference.

---

Hopefully this helped with the basics and understanding what you’re doing. There are probably great video resources out there that explain it more didactically than I do with steps you can follow along.

Good luck!

CC BY-NC-SA 4.0

If you’re not planning to actually learn Docker, use an LLM AI to help you out. I just tried the following prompt in Gemini “generate docker-compose.yml that runs audiobookshelf and Sonarr with Sabnzbd” and it generated something that looks reasonable. Then you can follow it up with prompts like “how do I auto start it on linux?” and it will generate the systemd unit, and also tell you what commands to run.

I can at least assure you that as a developer, docker is annoying to set up and their documentation is confusing.

Most things in Linux are easier to set up but sometimes installing things happens to be harder than it should be and docker is one of them.

You should keep in mind that compared to other OSs, a lot of Linux software is CLI only, so they won’t always show up in the applications list and you’ll need to check if you have it in a terminal.

podman is better but thats just my opinion btw