Docker Windows Install

How to Install ABS on Windows (Portainer Method)

> Thanks to EvilSerenityReborn on Discord for this contribution! <

Phase 1: Installation + Initial Setup

Step 1: Install Docker Desktop for Windows

Install on Windows

Phase 2:

  • Run DockerDesktop.exe
  • After Docker starts, you can click “Add Extensions” on the left pane.
  • Search for Portainer, click Install, and once done, Open it.
  • The home page should greet you with this layout:

CleanShot 2022-11-25 at 10.19.28@2x.png

  • Click on the “local” environment

CleanShot 2022-11-25 at 10.19.19@2x.png

  • Click on “Stacks”

CleanShot 2022-11-25 at 10.20.57@2x.png

  • And then click on “Add Stack” on the top right
  • Name your stack (I did “audiobookshelf”), and be sure your build method is Web Editor (for sake of ease)

CleanShot 2022-11-25 at 10.21.32@2x.png

  • Head over here:

    • And copy/paste the contents into the Web Editor in Docker Desktop:

  • This is what mine looks like. Yes, you have to remove the < > as well. I separated my library by overall genre, so I have three volumes pointed to their respective directories. (ignore the environment variables AUDIOBOOKSHELF_UID & AUDIOBOOKSHELF_GID have been deprecated)

CleanShot 2022-11-25 at 10.27.36@2x.png

  • Once edited, scroll down and click “Deploy”

Phase 3: THE SET UP

  • Open up your favorite browser and go to:
    • localhost:13378
    • If you want to find your device IP address, open up powershell and type:
Get-NetIPAddress -AddressFamily IPV4
  - Look for the one that starts with 192.168 or 10.0 … and then tack on the port
     - [example]
  • You should be greeted with the ABS page, so go ahead and create your account and set up your library (add library, name it, select the folder your audiobooks are in, etc.)

Phase 4: Opening Ports so you can access remotely

  • Warning! Opening the port on your router is the easiest way to access ABS outside of your home network but it is not secure. A secure way to do this is to setup a reverse proxy.
  • I’d recommend making your device’s IP static (google instructions), and then setting up port forwarding on your router to point to that local IP address:13378 port
  • You may also have to open up ports on your firewall (google instructions)
  • All that’s left is to find your public IPv4 address ( and using that as your server login instead of the localhost/localip.
    • So [public] instead of [local]


  • ABS will tell you when there is an update if you look at the lower left corner of your ABS web client (mine is the most recent version, but just imagine it says something like “update available”)

CleanShot 2022-11-25 at 10.45.04@2x.png

  • First, stop the ABS stack in Portainer (go to stacks on the left pane, click on the stack, and click on “stop this stack”)

CleanShot 2022-11-25 at 10.51.54@2x.png

  • go to the Images tab there and delete the audiobookshelf image.

CleanShot 2022-11-25 at 10.52.19@2x.png

  • Then go back to the Stacks tab and start up your ABS stack.