[GH-ISSUE #1714] (help needed) Guide to new Docker users (Portainer) #939

Closed
opened 2026-02-26 02:34:41 +03:00 by kerem · 1 comment
Owner

Originally created by @PauFCB on GitHub (Oct 14, 2023).
Original GitHub issue: https://github.com/koel/koel/issues/1714

Hi, I'm new with Docker, is there a step by step guide to install Koel using Portainer? I try with the guide but don't know what to do😅 thank you

Originally created by @PauFCB on GitHub (Oct 14, 2023). Original GitHub issue: https://github.com/koel/koel/issues/1714 Hi, I'm new with Docker, is there a step by step guide to install Koel using Portainer? I try with the guide but don't know what to do😅 thank you
kerem closed this issue 2026-02-26 02:34:41 +03:00
Author
Owner

@dmuiX commented on GitHub (Nov 6, 2023):

What did not work?

Doing it with docker-compose is straight forward:

  1. create directory koel wherever u want eg. mkdir ~/DockerCompose/koel and cd ~/DockerCompose/koel
  2. Download either docker-compose.mysql.yml or https://github.com/koel/docker/blob/master/docker-compose.postgres.yml from
    https://github.com/koel/docker
  3. change passwords <root_password> and <koel_password>
    and ports eg:
ports:
  - 8880:80

and the volume of your music folder eg:

volumes:
  - Enter Your absolute Music PATH:/music
  - covers:/var/www/html/public/img/covers
  - search_index:/var/www/html/storage/search-indexes

delete music volume:

volumes:
  music:
    driver: local

3.1 maybe you need to do sudo chown 33:33 Enter Your absolute Music PATH.
5. rename to docker-compose.yml (easier^^) or leave as is
6. do docker-compose up -d or if you haven't changed the name docker-compose up -d -f docker-compose.mysql.yml

portainer:

  1. Go to stacks
  2. click add new stack
  3. leave Build method on web-editor
  4. name: eg. koel
  5. In the field Web editor paste content from the above docker-compose.mysql.yml or docker-compose.postgres.yml
  6. change password and ports

Find out container name:
in terminal enter:
docker ps
and look for koel without database in it

init:
docker exec --user www-data -it <container_name_for_koel> php artisan koel:init --no-assets

change admin password:
docker exec --user www-data -it <container_name_for_koel> php artisan koel:admin:change-password

sync db:
docker exec --user www-data -it <container_name_for_koel> php artisan koel:sync -v

<!-- gh-comment-id:1796111561 --> @dmuiX commented on GitHub (Nov 6, 2023): What did not work? Doing it with docker-compose is straight forward: 1. create directory koel wherever u want eg. `mkdir ~/DockerCompose/koel` and `cd ~/DockerCompose/koel` 2. Download either [docker-compose.mysql.yml](https://github.com/koel/docker/blob/master/docker-compose.mysql.yml) or https://github.com/koel/docker/blob/master/docker-compose.postgres.yml from https://github.com/koel/docker 3. change passwords <root_password> and <koel_password> and ports eg: ``` ports: - 8880:80 ``` and the volume of your music folder eg: ``` volumes: - Enter Your absolute Music PATH:/music - covers:/var/www/html/public/img/covers - search_index:/var/www/html/storage/search-indexes ``` delete music volume: ``` volumes: music: driver: local ``` 3.1 maybe you need to do `sudo chown 33:33 Enter Your absolute Music PATH`. 5. rename to docker-compose.yml (easier^^) or leave as is 6. do docker-compose up -d or if you haven't changed the name `docker-compose up -d -f docker-compose.mysql.yml` portainer: 1. Go to stacks 2. click add new stack 3. leave Build method on web-editor 4. name: eg. koel 5. In the field Web editor paste content from the above docker-compose.mysql.yml or docker-compose.postgres.yml 7. change password and ports Find out container name: in terminal enter: ```docker ps``` and look for koel without database in it init: `docker exec --user www-data -it <container_name_for_koel> php artisan koel:init --no-assets` change admin password: `docker exec --user www-data -it <container_name_for_koel> php artisan koel:admin:change-password` sync db: `docker exec --user www-data -it <container_name_for_koel> php artisan koel:sync -v`
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/koel-koel#939
No description provided.