diff options
author | Roger Gonzalez <roger@rogs.me> | 2023-01-10 19:12:17 -0300 |
---|---|---|
committer | Roger Gonzalez <roger@rogs.me> | 2023-01-10 19:12:17 -0300 |
commit | 81a9aaa7e7eb560b2cabe4305a17965295eb5ba4 (patch) | |
tree | 2eaf0a4ba45c1b415c34caf45662064ff6525e91 | |
parent | b99cba3bc36d17a163fd6f590bb93b12f3339437 (diff) |
Changed "docs" for "install"
-rw-r--r-- | config.toml | 10 | ||||
-rw-r--r-- | content/docs/configure.md | 53 | ||||
-rw-r--r-- | content/docs/example.md | 35 | ||||
-rw-r--r-- | content/docs/install-hugo.md | 15 | ||||
-rw-r--r-- | content/docs/install-theme.md | 66 | ||||
-rw-r--r-- | content/docs/specimen.md | 187 | ||||
-rw-r--r-- | content/install/description.md | 46 | ||||
-rw-r--r-- | content/install/install.md | 173 | ||||
-rw-r--r-- | content/install/using-the-cli.md | 35 |
9 files changed, 259 insertions, 361 deletions
diff --git a/config.toml b/config.toml index f65402c..efb7839 100644 --- a/config.toml +++ b/config.toml @@ -23,18 +23,18 @@ summaryLength = 30 weight = 1 [[menu.main]] - name = "Docs" - url = "/docs/" + name = "Install" + url = "/install/" weight = 2 [params] - homepage_button_link = '/docs' - homepage_button_text = 'Read The Docs' + homepage_button_link = '/install' + homepage_button_text = 'Install YAMS' homepage_intro = 'YAMS is a basic but powerful media server, easy to install in a bash script' homepage_image = '/install-yams.gif' ## You can enable to add anchor links to header elements - # enable_anchor_link = true + enable_anchor_link = true [params.homepage_meta_tags] meta_description = "YAMS is a basic but powerful media server, easy to install in a bash script" diff --git a/content/docs/configure.md b/content/docs/configure.md deleted file mode 100644 index 48d9e60..0000000 --- a/content/docs/configure.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: 'Configuration' -date: 2019-02-11T19:30:08+10:00 -draft: false -weight: 4 -summary: Syntax highlighting and menus can be configured via `config.toml`. ---- - -## Syntax Highlighting - -Whisper uses the in-built code highlighting that ships with hugo. https://gohugo.io/content-management/syntax-highlighting/ - -You can insert code snippets in any markdown file by using standard code fences syntax ie: - -```` -``` -insert code here -``` -```` - -You can specify the langauge by adding a declaration after the backticks - -```` -```javascript -insert code here -``` -```` - -### Pygments Options - -The following code highlighting options are configured in the `config.toml` - -```toml -pygmentsCodeFences = true -pygmentsCodefencesGuessSyntax = true -pygmentsUseClasses = true -``` - -## Main menu - -Configure the main menu by editing the `config.toml` - -```toml -[[menu.main]] -name = "Home" -url = "/" -weight = 1 - -[[menu.main]] -name = "Docs" -url = "/docs/" -weight = 2 -``` diff --git a/content/docs/example.md b/content/docs/example.md deleted file mode 100644 index cdef287..0000000 --- a/content/docs/example.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 'Hugo Whisper' -date: 2019-02-11T19:27:37+10:00 -weight: 6 ---- - -Whisper is a minimal documentation theme built for Hugo. The design & functionality is intentionally minimal. - -<!--more--> - -## Quickstart - -Copy or git clone this theme into the sites themes folder `mynewsite/themes` - -``` -hugo new site whisper -git clone https://github.com/jugglerx/hugo-whisper-theme.git -``` - -### Code Highlighting - -Whisper uses Hugo's in-built code highlighting with a github style code highlighting theme. https://gohugo.io/content-management/syntax-highlighting/ - -You can insert code snippets in any markdown file by using standard code fences syntax ie: - -```js -function myFunction() { - var x = document.getElementById('myDIV'); - if (x.style.display === 'none') { - x.style.display = 'block'; - } else { - x.style.display = 'none'; - } -} -``` diff --git a/content/docs/install-hugo.md b/content/docs/install-hugo.md deleted file mode 100644 index f0a8a84..0000000 --- a/content/docs/install-hugo.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: 'Install Hugo' -date: 2019-02-11T19:27:37+10:00 -weight: 2 ---- - -To use this theme you will need to have Hugo installed. If you don't already have Hugo installed please follow the official [installation guide](https://gohugo.io/getting-started/installing/) - -### Check Hugo Version - -This theme uses [Hugo Pipes](https://gohugo.io/hugo-pipes/scss-sass/) to compile SCSS and minify assets. Please make sure you have the `Hugo Extended` version installed. If you are not using the extended version this theme will not not compile. - -``` -hugo version -``` diff --git a/content/docs/install-theme.md b/content/docs/install-theme.md deleted file mode 100644 index b1c41da..0000000 --- a/content/docs/install-theme.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: 'Install Theme' -date: 2019-02-11T19:27:37+10:00 -draft: false -weight: 3 ---- - -## Create a new Hugo site - -``` -hugo new site mynewsite -``` - -This will create a fresh Hugo site in the folder `mynewsite`. - -## Install theme - -Copy or git clone this theme into the sites themes folder `mynewsite/themes` - -#### Install with Git - -``` -cd mynewsite -cd themes -git clone https://github.com/jugglerx/hugo-whisper-theme.git -``` - -#### Install from .zip file - -You can download the .zip file located here https://github.com/JugglerX/hugo-whisper-theme/archive/master.zip. - -Extract the downloaded .zip inside the `themes` folder. Rename the extracted folder from `hugo-whisper-theme-master` -> `hugo-whisper-theme`. You should end up with the following folder structure `mynewsite/themes/hugo-whisper-theme` - -## Add example content - -The fastest way to get started is to copy the example content and modify the included `config.toml` - -### Copy exampleSite contents - -Copy the entire contents of the `exampleSite` folder to the root folder of your Hugo site _(the folder with the README.md)_. - -### Update config.toml - -After you copy the `config.toml` into the root folder of your Hugo site you will need to update the `baseURL`, `themesDir` and `theme` values in the `config.toml` - -``` -baseURL = "/" -themesDir = "themes" -theme = "hugo-whisper-theme" -``` - -## Run Hugo - -After installing the theme for the first time, generate the Hugo site. - -``` -hugo -``` - -For local development run Hugo's built-in local server. - -``` -hugo server -``` - -Now enter [`localhost:1313`](http://localhost:1313) in the address bar of your browser. diff --git a/content/docs/specimen.md b/content/docs/specimen.md deleted file mode 100644 index 031bceb..0000000 --- a/content/docs/specimen.md +++ /dev/null @@ -1,187 +0,0 @@ ---- -title: 'Specimen' -date: 2019-02-11T19:27:37+10:00 -weight: 5 ---- - -# <a name="top"></a>Markdown Test Page - -- [Headings](#Headings) -- [Paragraphs](#Paragraphs) -- [Blockquotes](#Blockquotes) -- [Lists](#Lists) -- [Horizontal rule](#Horizontal) -- [Table](#Table) -- [Code](#Code) -- [Inline elements](#Inline) - ---- - -# <a name="Headings"></a>Headings - -# Heading one - -Sint sit cillum pariatur eiusmod nulla pariatur ipsum. Sit laborum anim qui mollit tempor pariatur nisi minim dolor. Aliquip et adipisicing sit sit fugiat commodo id sunt. Nostrud enim ad commodo incididunt cupidatat in ullamco ullamco Lorem cupidatat velit enim et Lorem. - -## Heading two - -Aute officia nulla deserunt do deserunt cillum velit magna. Officia veniam culpa anim minim dolore labore pariatur voluptate id ad est duis quis velit dolor pariatur enim. Incididunt enim excepteur do veniam consequat culpa do voluptate dolor fugiat ad adipisicing sit. - -### Heading three - -Voluptate cupidatat cillum elit quis ipsum eu voluptate fugiat consectetur enim. Quis ut voluptate culpa ex anim aute consectetur dolore proident voluptate exercitation eiusmod. Esse in do anim magna minim culpa sint. Adipisicing ipsum consectetur proident ullamco magna sit amet aliqua aute fugiat laborum exercitation duis et. - -#### Heading four - -Commodo fugiat aliqua minim quis pariatur mollit id tempor. Non occaecat minim esse enim aliqua adipisicing nostrud duis consequat eu adipisicing qui. Minim aliquip sit excepteur ipsum consequat laborum pariatur excepteur. - -##### Heading five - -Veniam enim esse amet veniam deserunt laboris amet enim consequat. Minim nostrud deserunt cillum consectetur commodo eu enim nostrud ullamco occaecat excepteur. Aliquip et ut est commodo enim dolor amet sint excepteur. Amet ad laboris laborum deserunt sint sunt aliqua commodo ex duis deserunt enim est ex labore ut. - -###### Heading six - -Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. - -[[Top]](#top) - -# <a name="Paragraphs"></a>Paragraphs - -Incididunt ex adipisicing ea ullamco consectetur in voluptate proident fugiat tempor deserunt reprehenderit ullamco id dolore laborum. Do laboris laboris minim incididunt qui consectetur exercitation adipisicing dolore et magna consequat magna anim sunt. Officia fugiat Lorem sunt pariatur incididunt Lorem reprehenderit proident irure. Dolore ipsum aliqua mollit ad officia fugiat sit eu aliquip cupidatat ipsum duis laborum laborum fugiat esse. Voluptate anim ex dolore deserunt ea ex eiusmod irure. Occaecat excepteur aliqua exercitation aliquip dolor esse eu eu. - -Officia dolore laborum aute incididunt commodo nisi velit est est elit et dolore elit exercitation. Enim aliquip magna id ipsum aliquip consectetur ad nulla quis. Incididunt pariatur dolor consectetur cillum enim velit cupidatat laborum quis ex. - -Officia irure in non voluptate adipisicing sit amet tempor duis dolore deserunt enim ut. Reprehenderit incididunt in ad anim et deserunt deserunt Lorem laborum quis. Enim aute anim labore proident laboris voluptate elit excepteur in. Ex labore nulla velit officia ullamco Lorem Lorem id do. Dolore ullamco ipsum magna dolor pariatur voluptate ipsum id occaecat ipsum. Dolore tempor quis duis commodo quis quis enim. - -[[Top]](#top) - -# <a name="Blockquotes"></a>Blockquotes - -Ad nisi laborum aute cupidatat magna deserunt eu id laboris id. Aliquip nulla cupidatat sint ex Lorem mollit laborum dolor amet est ut esse aute. Nostrud ex consequat id incididunt proident ipsum minim duis aliqua ut ex et ad quis. Laborum sint esse cillum anim nulla cillum consectetur aliqua sit. Nisi excepteur cillum labore amet excepteur commodo enim occaecat consequat ipsum proident exercitation duis id in. - -> Ipsum et cupidatat mollit exercitation enim duis sunt irure aliqua reprehenderit mollit. Pariatur Lorem pariatur laboris do culpa do elit irure. Eiusmod amet nulla voluptate velit culpa et aliqua ad reprehenderit sit ut. - -Labore ea magna Lorem consequat aliquip consectetur cillum duis dolore. Et veniam dolor qui incididunt minim amet laboris sit. Dolore ad esse commodo et dolore amet est velit ut nisi ea. Excepteur ea nulla commodo dolore anim dolore adipisicing eiusmod labore id enim esse quis mollit deserunt est. Minim ea culpa voluptate nostrud commodo proident in duis aliquip minim. - -> Qui est sit et reprehenderit aute est esse enim aliqua id aliquip ea anim. Pariatur sint reprehenderit mollit velit voluptate enim consectetur sint enim. Quis exercitation proident elit non id qui culpa dolore esse aliquip consequat. - -Ipsum excepteur cupidatat sunt minim ad eiusmod tempor sit. - -> Deserunt excepteur adipisicing culpa pariatur cillum laboris ullamco nisi fugiat cillum officia. In cupidatat nulla aliquip tempor ad Lorem Lorem quis voluptate officia consectetur pariatur ex in est duis. Mollit id esse est elit exercitation voluptate nostrud nisi laborum magna dolore dolore tempor in est consectetur. - -Adipisicing voluptate ipsum culpa voluptate id aute laboris labore esse fugiat veniam ullamco occaecat do ut. Tempor et esse reprehenderit veniam proident ipsum irure sit ullamco et labore ea excepteur nulla labore ut. Ex aute minim quis tempor in eu id id irure ea nostrud dolor esse. - -[[Top]](#top) - -# <a name="Lists"></a>Lists - -### Ordered List - -1. Longan -2. Lychee -3. Excepteur ad cupidatat do elit laborum amet cillum reprehenderit consequat quis. - Deserunt officia esse aliquip consectetur duis ut labore laborum commodo aliquip aliquip velit pariatur dolore. -4. Marionberry -5. Melon - - Cantaloupe - - Honeydew - - Watermelon -6. Miracle fruit -7. Mulberry - -### Unordered List - -- Olive -- Orange - - Blood orange - - Clementine -- Papaya -- Ut aute ipsum occaecat nisi culpa Lorem id occaecat cupidatat id id magna laboris ad duis. Fugiat cillum dolore veniam nostrud proident sint consectetur eiusmod irure adipisicing. -- Passionfruit - -[[Top]](#top) - -# <a name="Horizontal"></a>Horizontal rule - -In dolore velit aliquip labore mollit minim tempor veniam eu veniam ad in sint aliquip mollit mollit. Ex occaecat non deserunt elit laborum sunt tempor sint consequat culpa culpa qui sit. Irure ad commodo eu voluptate mollit cillum cupidatat veniam proident amet minim reprehenderit. - ---- - -In laboris eiusmod reprehenderit aliquip sit proident occaecat. Non sit labore anim elit veniam Lorem minim commodo eiusmod irure do minim nisi. Dolor amet cillum excepteur consequat sint non sint. - -[[Top]](#top) - -# <a name="Table"></a>Table - -Duis sunt ut pariatur reprehenderit mollit mollit magna dolore in pariatur nulla commodo sit dolor ad fugiat. Laboris amet ea occaecat duis eu enim exercitation deserunt ea laborum occaecat reprehenderit. Et incididunt dolor commodo consequat mollit nisi proident non pariatur in et incididunt id. Eu ut et Lorem ea ex magna minim ipsum ipsum do. - -| Table Heading 1 | Table Heading 2 | Center align | Right align | Table Heading 5 | -| :-------------- | :-------------- | :----------: | ----------: | :-------------- | -| Item 1 | Item 2 | Item 3 | Item 4 | Item 5 | -| Item 1 | Item 2 | Item 3 | Item 4 | Item 5 | -| Item 1 | Item 2 | Item 3 | Item 4 | Item 5 | -| Item 1 | Item 2 | Item 3 | Item 4 | Item 5 | -| Item 1 | Item 2 | Item 3 | Item 4 | Item 5 | - -Minim id consequat adipisicing cupidatat laborum culpa veniam non consectetur et duis pariatur reprehenderit eu ex consectetur. Sunt nisi qui eiusmod ut cillum laborum Lorem officia aliquip laboris ullamco nostrud laboris non irure laboris. Cillum dolore labore Lorem deserunt mollit voluptate esse incididunt ex dolor. - -[[Top]](#top) - -# <a name="Code"></a>Code - -## Inline code - -Ad amet irure est magna id mollit Lorem in do duis enim. Excepteur velit nisi magna ea pariatur pariatur ullamco fugiat deserunt sint non sint. Duis duis est `code in text` velit velit aute culpa ex quis pariatur pariatur laborum aute pariatur duis tempor sunt ad. Irure magna voluptate dolore consectetur consectetur irure esse. Anim magna `<strong>in culpa qui officia</strong>` dolor eiusmod esse amet aute cupidatat aliqua do id voluptate cupidatat reprehenderit amet labore deserunt. - -## Highlighted - -Et fugiat ad nisi amet magna labore do cillum fugiat occaecat cillum Lorem proident. In sint dolor ullamco ad do adipisicing amet id excepteur Lorem aliquip sit irure veniam laborum duis cillum. Aliqua occaecat minim cillum deserunt magna sunt laboris do do irure ea nostrud consequat ut voluptate ex. - -```go -package main - -import ( - "fmt" - "net/http" -) - -func handler(w http.ResponseWriter, r *http.Request) { - fmt.Fprintf(w, "Hi there, I love %s!", r.URL.Path[1:]) -} - -func main() { - http.HandleFunc("/", handler) - http.ListenAndServe(":8080", nil) -} -``` - -Ex amet id ex aliquip id do laborum excepteur exercitation elit sint commodo occaecat nostrud est. Nostrud pariatur esse veniam laborum non sint magna sit laboris minim in id. Aliqua pariatur pariatur excepteur adipisicing irure culpa consequat commodo et ex id ad. - -```js -function myFunction() { - var x = document.getElementById('myDIV'); - if (x.style.display === 'none') { - x.style.display = 'block'; - } else { - x.style.display = 'none'; - } -} -``` - -[[Top]](#top) - -# <a name="Inline"></a>Inline elements - -Sint ea anim ipsum ad commodo cupidatat do **exercitation** incididunt et minim ad labore sunt. Minim deserunt labore laboris velit nulla incididunt ipsum nulla. Ullamco ad laborum ea qui et anim in laboris exercitation tempor sit officia laborum reprehenderit culpa velit quis. **Consequat commodo** reprehenderit duis [irure](#!) esse esse exercitation minim enim Lorem dolore duis irure. Nisi Lorem reprehenderit ea amet excepteur dolor excepteur magna labore proident voluptate ipsum. Reprehenderit ex esse deserunt aliqua ea officia mollit Lorem nulla magna enim. Et ad ipsum labore enim ipsum **cupidatat consequat**. Commodo non ea cupidatat magna deserunt dolore ipsum velit nulla elit veniam nulla eiusmod proident officia. - -![Super wide](https://placekitten.com/1280/800) - -_Proident sit veniam in est proident officia adipisicing_ ea tempor cillum non cillum velit deserunt. Voluptate laborum incididunt sit consectetur Lorem irure incididunt voluptate nostrud. Commodo ut eiusmod tempor cupidatat esse enim minim ex anim consequat. Mollit sint culpa qui laboris quis consectetur ad sint esse. Amet anim anim minim ullamco et duis non irure. Sit tempor adipisicing ea laboris `culpa ex duis sint` anim aute reprehenderit id eu ea. Aute [excepteur proident](#!) Lorem minim adipisicing nostrud mollit ad ut voluptate do nulla esse occaecat aliqua sint anim. - -![Not so big](https://placekitten.com/480/400) - -Incididunt in culpa cupidatat mollit cillum qui proident sit. In cillum aliquip incididunt voluptate magna amet cupidatat cillum pariatur sint aliqua est _enim **anim** voluptate_. Magna aliquip proident incididunt id duis pariatur eiusmod incididunt commodo culpa dolore sit. Culpa do nostrud elit ad exercitation anim pariatur non minim nisi **adipisicing sunt _officia_**. Do deserunt magna mollit Lorem commodo ipsum do cupidatat mollit enim ut elit veniam ea voluptate. - -[![Box](https://img.youtube.com/vi/qEuD6v1Y9fg/0.jpg)](https://www.youtube.com/watch?v=qEuD6v1Y9fg) - -Reprehenderit non eu quis in ad elit esse qui aute id [incididunt](#!) dolore cillum. Esse laboris consequat dolor anim exercitation tempor aliqua deserunt velit magna laboris. Culpa culpa minim duis amet mollit do quis amet commodo nulla irure. diff --git a/content/install/description.md b/content/install/description.md new file mode 100644 index 0000000..3afec2f --- /dev/null +++ b/content/install/description.md @@ -0,0 +1,46 @@ +--- +title: "What is YAMS?" +date: 2023-01-10T15:23:19-03:00 +draft: false +weight: 1 +summary: A brief summary on what YAMS is and its features +--- + +YAMS is a is a **highly opinionated** media server. + +With YAMS you'll be able to automate your media gathering, organization and consumption. + +## First, why? + +I wanted a setup that my non technical girlfiend could use without any problems, so I started designing my media server using multiple open source projects, and running them on top of docker. + +Fast forward two years and I would like to say it works very well 😎 And most importantly, I acomplished my goal: My girlfiend uses it very regularly and I've even expanded it to my Mother, who lives 5000kms from me. + +My friends wanted to have a media server like mine, but it was always hard to explain everything that was involved in building and connecting all the pieces together. + +So basically, my friends pushed me to build this script and documentation, so they (and now anyone!) could build it on their own homeservers. + +## Features + +In no particular order: + +- **Automatic shows/movies download:** Just add your shows and movies to the watch list and it should automatically download the files as soon as they are available. +- **Automatic clasification and organization:** Your media files should be completely organized by default. +- **Automatic subtitles download:** Self explanatory. Your media server should automatically download subtitles in the languages you choose, if they are available. +- **Support for Web, Android, iOS, Android TV and whatever that can support Emby:** Since we are leveraging from Emby, you should be able to watch your favorite media almost anywhere. + + +## What's installed with YAMS? + +- [Sonarr](https://sonarr.tv/) +- [Radarr](https://radarr.video/) +- [Emby](https://emby.media/) +- [qBittorrent](https://www.qbittorrent.org/) +- [Bazarr](https://www.bazarr.media/) +- [Jackett](https://github.com/Jackett/Jackett) + +With this combination, you can create a fully functional media server that is going to download, categorize, subtitle and serve your favorite shows and movies. + +## Why did you choose <this_software> instead of <that_software>? + +Because. That's why it's _**opinionated**_, you don't _necessarily_ have to agree with me. This setup is aimed at noobs and first time media server enthusiasts. You can always use my sources and create a better project 🔥 diff --git a/content/install/install.md b/content/install/install.md new file mode 100644 index 0000000..c0f6f40 --- /dev/null +++ b/content/install/install.md @@ -0,0 +1,173 @@ +--- +title: Installation +date: 2023-01-10T15:23:20-03:00 +weight: 2 +summary: First steps to install YAMS on your server +--- + +## Dependencies + +This script only depends on: + +- Debian 11 (recommended) or Ubuntu 22.04. +- [docker](https://www.docker.com/). +- [docker-compose](https://docs.docker.com/compose/). + +If you haven’t installed `docker` and `docker-compose`, don’t worry! The script will attempt to run both installations (it only works in Debian and Ubuntu!) + +## Before running +Before installing, make sure you have: + +- **An installation location:** The script is going to ask you for a install location, but it will default to `/opt/yams`. Just make sure your current user has permissions to write on the selected directory. +- **A media folder:** This is the folder where all your files are going to be downloaded and categorized. For example, if you choose `/srv/media`, the script is going to create the following folders: + + `/srv/media/tv`: For your TV shows. + + `/srv/media/movies`: For your movies. + + `/srv/media/downloads`: For your torrent downloads. + + `/srv/media/blackhole`: For your torrents blackhole. +- **A regular user to run and own the media files:** You shouldn’t use `root` for this user, but I’m not your father, nothing is going to stop you lol + +## To install + +### Setup your install location (optional, you can choose any other location) + +The location `/opt/yams` is **recommended**, but you can use whatever you like if your current user has permissions on the directory. + +```bash +sudo mkdir -p /opt/yams +sudo chown -R $USER:$USER /opt/yams +``` + +### Cloning from Gitlab +```bash +git clone https://gitlab.com/rogs/yams.git +cd yams +``` + +### Installing docker (optional) +If you have `docker` and `docker-compose` installed, you can skip this part. + +To install `docker`, just run: + +```bash +./install.sh +``` + +You'll see the following prompt: + +```bash +==================================================== + ___ ___ ___ + ___ / /\ /__/\ / /\ + /__/| / /::\ | |::\ / /:/_ + | |:| / /:/\:\ | |:|:\ / /:/ /\ + | |:| / /:/~/::\ __|__|:|\:\ / /:/ /::\ + __|__|:| /__/:/ /:/\:\ /__/::::| \:\ /__/:/ /:/\:\ +/__/::::\ \ \:\/:/__\/ \ \:\~~\__\/ \ \:\/:/~/:/ + ~\~~\:\ \ \::/ \ \:\ \ \::/ /:/ + \ \:\ \ \:\ \ \:\ \__\/ /:/ + \__\/ \ \:\ \ \:\ /__/:/ + \__\/ \__\/ \__\/ +==================================================== +Welcome to YAMS (Yet Another Media Server) +Instalation process should be really quick +We just need you to answer some questions +==================================================== + +Checking prerequisites... + ⚠️ docker not found! ⚠️ +Do you want YAMS to install docker and docker-compose? IT ONLY WORKS ON DEBIAN AND UBUNTU! [y/N]: y +``` + +If you choose to install docker with YAMS, you'll see the following message: + +```bash +🤔 When docker finishes the installation, run ./install again! 🧠 +Press [ENTER] to continue... +``` +**Note:** The script will ask you for your `sudo` password in order to continue ⚠️ + +### Installing YAMS + +To install YAMS, just re-run: + +```bash +./install.sh +``` + +And you should see the following message at the bottom: + +```bash +Checking prerequisites... +docker exists ✅ +docker-compose exists ✅ +Where do you want to install the docker-compose file? [/opt/yams]: +``` + +You should choose the path where you want YAMS to be installed. Like I said before, the `/opt/yams` directory **is recommended**, but you can use whatever you like if your current user has permissions on the directory. Type the path you'll like to use and press `[ENTER]` to continue. + +```bash +What's the user that is going to own the media server files? [your_current_user]: +``` + +Now, you have to choose the user that is going to own your media files. **I strongly suggest you don't use `root` for this user**, but you can do whatever you want. The script is going to default to the current `$USER` running the script. Type the user you want to own the files and press `[ENTER]` to continue. + +```bash +Please, input your media folder: +``` + +My suggestion is to use something like `/srv/media`, but you _might_ want to use an external hard drive or a different partition on your machine. Just type the full path of the directory you want to use and press `[ENTER]` to continue. If it doesn't exist, the script is going to try to create it. + +```bash +Are you sure your media folder is /srv/media? [y/N]: +``` + +Select `y` or `n` if you are happy with the folder you selected. Press `[ENTER]` to continue. + +```bash +Copying /opt/yams/docker-compose.yaml... +Everything installed correctly! 🎉 +... + +... + +... +``` + +After a lot of docker installing, you'll get this message at the end: + +```bash +======================================================== + _____ ___ ___ ___ + / /::\ / /\ /__/\ / /\ + / /:/\:\ / /::\ \ \:\ / /:/_ + / /:/ \:\ / /:/\:\ \ \:\ / /:/ /\ + /__/:/ \__\:| / /:/ \:\ _____\__\:\ / /:/ /:/_ + \ \:\ / /:/ /__/:/ \__\:\ /__/::::::::\ /__/:/ /:/ /\ + \ \:\ /:/ \ \:\ / /:/ \ \:\~~\~~\/ \ \:\/:/ /:/ + \ \:\/:/ \ \:\ /:/ \ \:\ ~~~ \ \::/ /:/ + \ \::/ \ \:\/:/ \ \:\ \ \:\/:/ + \__\/ \ \::/ \ \:\ \ \::/ + \__\/ \__\/ \__\/ +======================================================== +All done!✅ Enjoy YAMS! +You can check the installation on /opt/yams +======================================================== +Everythins should be running now! To check everything running, go to: + +Sonarr: http://192.168.0.169:8989/ +Radarr: http://192.168.0.169:7878/ +Bazarr: http://192.168.0.169:6767/ +Jackett: http://192.168.0.169:9117/ +Emby: http://192.168.0.169:8096/ +qBittorrent: http://192.168.0.169:8080/ + + +You might need to wait for a couple of minutes while everything gets up and running + +All the services location are also saved in ~/yams_services.txt +======================================================== +``` + +And that's it! + +In your browser, you can visit each of the sites to check that they are running correctly. If one of them don't show up, you might need to wait a couple of minutes for docker to finish the full installation. diff --git a/content/install/using-the-cli.md b/content/install/using-the-cli.md new file mode 100644 index 0000000..9613d79 --- /dev/null +++ b/content/install/using-the-cli.md @@ -0,0 +1,35 @@ +--- +title: "Using the CLI" +date: 2023-01-10T17:55:41-03:00 +draft: false +weight: 3 +summary: YAMS comes with a very handy CLI to manage all your media server. Here's where you'll learn how to use it. +--- + +YAMS comes with a very handy CLI to manage all your media server. Here's where you'll learn how to use it. + +On your server, you can type: +```bash +yams --help +``` + +And you'll get the following message: + +```bash +yams - Yet Another Media Server + +Usage: yams [--help|restart|stop|start] +options: +--help displays this help message +restart restarts yams services +stop stops all yams services +start starts yams services +destroy destroy yams services so you can start from scratch +``` + +Everything is very self-explanatory, but I'll go in more detail here: + +- `restart`: Restarts all the services. It stops them gracefully and starts them again. +- `stop`: Stops all the services gracefully. +- `start`: Starts all the services. +- `destroy`: Destroys all the services so you can start the configuration from scrath. ⚠️ Be careful! ⚠️ There's no going back after this! |