From e9908774609bc12ae6426e27f6ecd8dd3698f5bb Mon Sep 17 00:00:00 2001 From: mungai-njoroge Date: Fri, 13 Oct 2023 22:37:30 +0300 Subject: [PATCH] update readme --- README.md | 48 ++++++++++++++++-------------------------------- 1 file changed, 16 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 6083c0f..7609c4b 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,9 @@ To stream your music across your local network, use the `--host` flag to run the swingmusic --host 0.0.0.0 ``` -The link to access the app will be printed on your terminal. Copy it and open it in your browser. +The link to access the app will be printed on your terminal. Open it in your browser to use Swing Music. + +[Browse Docs](https://swingmusic.vercel.app) ### Docker @@ -58,21 +60,27 @@ Pull the latest Docker image and run it: docker pull ghcr.io/swing-opensource/swingmusic:v1.3.0 ``` -```bash -git clone https://github.com/swing-opensource/swingmusic.git --depth 1 -cd swingmusic -docker build . -t swingmusic +```sh +docker run --name swingmusic -p 1970:1970 \ + -v /path/to/music:/music \ + -v /path/to/config:/config \ + --restart unless-stopped \ + ghcr.io/swing-opensource/swingmusic:latest ``` -Then create the container. Here are some example snippets to help you get started creating a container. +Don't forget to replace `/path/to/music` and `/path/to/config` with the appropriate values. In addition, specify the the `/music` directory as the root directory. Using the `Home Directory` option won't work. -#### docker-compose +For more info, see the [Docker section](https://swingmusic.vercel.app/guide/getting-started.html#docker) on the docs. + +#### Using Docker Compose + +Here's a sample Docker compose file: ```yaml --- version: "3.8" services: - swing: + swingmusic: image: swingmusic container_name: swingmusic volumes: @@ -83,30 +91,6 @@ services: restart: unless-stopped ``` -#### docker cli - -```bash -docker run -d \ - --name=swingmusic \ - -p 1970:1970 \ - -v /path/to/music:/music \ - -v /path/to/config:/config \ - --restart unless-stopped \ - swingmusic -``` - -#### Parameters - -Container images are configured using parameters passed at runtime (such as those above). These parameters are separated -by a colon and indicate `:` respectively. For example, `-p 8080:80` would expose port `80` from -inside the container to be accessible from the host's IP on port `8080` outside the container. - -| Parameter | Function | -| :----------: | -------------------------------------------------------------------------------------------- | -| `-p 1970` | WebUI | -| `-v /music` | Recommended directory to store your music collection. You can bind other folder if you wish. | -| `-v /config` | Configuration files. | - ### Contributing See [contributing guidelines](.github/contributing.md).