mirror of
				https://github.com/tiyn/wiki.git
				synced 2025-10-31 18:31:15 +01:00 
			
		
		
		
	docker-images: added mikenye/picard and related articles and updated links in old ones
This commit is contained in:
		
							
								
								
									
										61
									
								
								wiki/docker-images/mikenye_-_picard.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										61
									
								
								wiki/docker-images/mikenye_-_picard.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,61 @@ | |||||||
|  | # mikenye - airsonic-advanced | ||||||
|  |  | ||||||
|  | This is a [Docker](/wiki/docker.md) container for a | ||||||
|  | [Picard](/wiki/picard.md) instance accessible over the web and | ||||||
|  | [VNC](/wiki/vnc.md). | ||||||
|  | The official container and documentation was made by | ||||||
|  | [mikenye](https://github.com/mikenye/docker-picard). | ||||||
|  |  | ||||||
|  | ## Set-up | ||||||
|  |  | ||||||
|  | Create the file `rebuild.sh`. | ||||||
|  | Change the settings according to your needs and run `./rebuild.sh` afterwards. | ||||||
|  |  | ||||||
|  | ## Environment-variables | ||||||
|  |  | ||||||
|  | Set the following variables with the -e tag. | ||||||
|  |  | ||||||
|  | | Name             | Usage               | Default | | ||||||
|  | | ---------------- | ------------------- | ------- | | ||||||
|  | | `USER_ID`        | UserID              | `1000`  | | ||||||
|  | | `GROUP_ID`       | GroupID             | `1000`  | | ||||||
|  | | `DISPLAY_WIDTH`  | Width of software   | `1280`  | | ||||||
|  | | `DISPLAY_HEIGHT` | Height of software  | `768`   | | ||||||
|  |  | ||||||
|  | ## Volumes | ||||||
|  |  | ||||||
|  | Set the following volumes with the -v tag. | ||||||
|  |  | ||||||
|  | | Outside mount/volume name | Container mount | Description               | | ||||||
|  | | ------------------------- | --------------- | ------------------------- | | ||||||
|  | | `config`                  | `/config`       | Configuration files       | | ||||||
|  | | `media_music`             | `/storage`      | Location for audio files  | | ||||||
|  |  | ||||||
|  | ## Ports | ||||||
|  |  | ||||||
|  | Set the following ports with the -p tag. | ||||||
|  |  | ||||||
|  | | Container Port | Recommended outside port | Protocol | Description                | | ||||||
|  | | -------------- | ------------------------ | -------- | -------------------------- | | ||||||
|  | | `5800`         | `5800`                   | TCP      | WebUI                      | | ||||||
|  | | `5900`         | `5900`                   | TCP      | VNC                        | | ||||||
|  | | `8000`         | `8000`                   | TCP      | Picard browser integration | | ||||||
|  |  | ||||||
|  | ## rebuild.sh | ||||||
|  |  | ||||||
|  | ```sh | ||||||
|  | #!/bin/sh | ||||||
|  | docker stop picard | ||||||
|  | docker rm picard | ||||||
|  | docker pull mikenye/picard | ||||||
|  | docker run --name=picard \ | ||||||
|  |   --restart unless-stopped \ | ||||||
|  |   -p 5800:5800 \ | ||||||
|  |   -v media_music:/storage:rw \ | ||||||
|  |   -v picard_config:/config:rw \ | ||||||
|  |   -e USER_ID=0 \ | ||||||
|  |   -e GROUP_ID=0 \ | ||||||
|  |   -e DISPLAY_WIDTH=2560 \ | ||||||
|  |   -e DISPLAY_HEIGHT=1440 \ | ||||||
|  |   -d mikenye/picard | ||||||
|  | ``` | ||||||
| @@ -9,14 +9,17 @@ Due to easy handling and reproducable environments it is a useful tool. | |||||||
| - Ubuntu: visit [the official installation guide](https://docs.docker.com/engine/install/ubuntu/) | - Ubuntu: visit [the official installation guide](https://docs.docker.com/engine/install/ubuntu/) | ||||||
|  |  | ||||||
| Another possibility is to try the official convenience script. | Another possibility is to try the official convenience script. | ||||||
| To get and execute it run the following in your terminal. | To get and execute it run the following in your | ||||||
|  | [terminal](/wiki/system_console.md). | ||||||
|  |  | ||||||
| ```sh | ```sh | ||||||
| curl -fsSL https://get.docker.com -o get-docker.sh | curl -fsSL https://get.docker.com -o get-docker.sh | ||||||
| sudo sh get-docker.sh | sudo sh get-docker.sh | ||||||
| ``` | ``` | ||||||
|  |  | ||||||
| ## Run Docker as non-root user | ## Usage | ||||||
|  |  | ||||||
|  | ### Run Docker as non-root user | ||||||
|  |  | ||||||
| To run docker as a non-root user you need to add your user to the `docker` group. | To run docker as a non-root user you need to add your user to the `docker` group. | ||||||
| To do this create the group docker if it doesn't exist `sudo groupadd docker` | To do this create the group docker if it doesn't exist `sudo groupadd docker` | ||||||
| @@ -24,14 +27,14 @@ and then add your user to the group using `sudo usermod -aG docker $USER`. | |||||||
| After that relog into your machine and you should be able to run | After that relog into your machine and you should be able to run | ||||||
| `docker run hello-world`. | `docker run hello-world`. | ||||||
|  |  | ||||||
| ## Tools and Visualisation | ### Tools and Visualisation | ||||||
|  |  | ||||||
| The programs below are useful docker-management systems in different style. | The programs below are useful docker-management systems in different style. | ||||||
|  |  | ||||||
| - [ctop](https://github.com/bcicen/ctop): top-like cli interface for containers | - [ctop](https://github.com/bcicen/ctop): top-like cli interface for containers | ||||||
| - [portainer](./docker-images/portainer.md): web ui for managing docker and kubernetes | - [portainer](./docker-images/portainer.md): web ui for managing docker and kubernetes | ||||||
|  |  | ||||||
| ## Enable Nvidia GPUs | ### Enable Nvidia GPUs | ||||||
|  |  | ||||||
| To use Nvidia GPUs with docker you need to install the nvidia-cuda-toolkit. | To use Nvidia GPUs with docker you need to install the nvidia-cuda-toolkit. | ||||||
| There is a [guide on marmelab](https://marmelab.com/blog/2018/03/21/using-nvidia-gpu-within-docker-container.html) | There is a [guide on marmelab](https://marmelab.com/blog/2018/03/21/using-nvidia-gpu-within-docker-container.html) | ||||||
| @@ -39,8 +42,8 @@ that focusses on that topic. | |||||||
|  |  | ||||||
| ### Block remote port access | ### Block remote port access | ||||||
|  |  | ||||||
| If you configured a reverse proxy to a port chances are you don't want the port | If you configured a [reverse proxy](/wiki/reverse-proxy.md) to a port chances | ||||||
| to be accessed outside of the proxy. | are you don't want the port to be accessed outside of the proxy. | ||||||
| Especially if you set up a authentication over nginx the open port will avoid | Especially if you set up a authentication over nginx the open port will avoid | ||||||
| the authentication. | the authentication. | ||||||
| This can be changed at the forwarded docker-service by replacing for example | This can be changed at the forwarded docker-service by replacing for example | ||||||
| @@ -50,3 +53,11 @@ network, effectively banning remote access. | |||||||
|  |  | ||||||
| If you use [Traefik](./traefik.md) it is not needed, because you don't have to | If you use [Traefik](./traefik.md) it is not needed, because you don't have to | ||||||
| publish ports to reverse proxy them. | publish ports to reverse proxy them. | ||||||
|  |  | ||||||
|  | ### Dockerize a graphical application | ||||||
|  |  | ||||||
|  | A graphical application can easily be dockerized and made available over both | ||||||
|  | the [web browser](/wiki/browser.md) or [VNC](/wiki/vnc.md). | ||||||
|  | For this | ||||||
|  | [jlesages baseimage-gui container](https://hub.docker.com/r/jlesage/baseimage-gui) | ||||||
|  | can be used. | ||||||
|   | |||||||
| @@ -3,29 +3,33 @@ | |||||||
| [Firefox](https://www.mozilla.org/en-US/Firefox) is a free and open-source web | [Firefox](https://www.mozilla.org/en-US/Firefox) is a free and open-source web | ||||||
| browser. | browser. | ||||||
|  |  | ||||||
| ## Telemetry |  | ||||||
|  |  | ||||||
| Telemetry is the remote measurement and transmission of data. |  | ||||||
| To change the telemetry of Firefox navigate to `about:telemetry` and click the |  | ||||||
| options to toggle between enabled and disabled. |  | ||||||
|  |  | ||||||
| ## Configuration | ## Configuration | ||||||
|  |  | ||||||
| Firefox has many possible settings and precerences. | Firefox has many possible settings and precerences. | ||||||
| This section addresses possible settings and preferences for specific use cases. | This section addresses possible settings and preferences for specific use cases. | ||||||
|  |  | ||||||
| ### Scrolling | ### Telemetry | ||||||
|  |  | ||||||
|  | Telemetry is the remote measurement and transmission of data. | ||||||
|  | To change the telemetry of Firefox navigate to `about:telemetry` and click the | ||||||
|  | options to toggle between enabled and disabled. | ||||||
|  |  | ||||||
|  | ### Enable/Disable Scrolling | ||||||
|  |  | ||||||
| On Linux distributions auto scroll is disabled by default. | On Linux distributions auto scroll is disabled by default. | ||||||
| This means that you cant click the middle mouse button to use it for scrolling. | This means that you cant click the middle mouse button to use it for scrolling. | ||||||
| To enable it go into the preferences and check `Use autoscrolling`. | To enable it go into the preferences and check `Use autoscrolling`. | ||||||
|  |  | ||||||
| ### Sponsorings | ### Enable/Disable Sponsorings | ||||||
|  |  | ||||||
| Sponsorings are embedded ads in Firefox. | Sponsorings are embedded ads in Firefox. | ||||||
| After navigating to `about:config` enabling and disabling of sponsorings can be done at | After navigating to `about:config` enabling and disabling of sponsorings can be done at | ||||||
| `browser.newtabpage.activity-stream.showSponsored`. | `browser.newtabpage.activity-stream.showSponsored`. | ||||||
|  |  | ||||||
|  | ## Usage | ||||||
|  |  | ||||||
|  | The following section addresses different uses and add-ons of Firefox. | ||||||
|  |  | ||||||
| ### Compact Mode | ### Compact Mode | ||||||
|  |  | ||||||
| In Firefox compact mode is a configuration to make tabs and navigation elements | In Firefox compact mode is a configuration to make tabs and navigation elements | ||||||
|   | |||||||
| @@ -87,8 +87,8 @@ It will display the list of games inside the wishlist. | |||||||
| Identify the game that has been removed and is not shown in the wishlist | Identify the game that has been removed and is not shown in the wishlist | ||||||
| anymore. | anymore. | ||||||
| Remember the `appid` of the game | Remember the `appid` of the game | ||||||
| Then run the following command inside the console and change `<appid>` | Then run the following command inside the [console](/wiki/system_console.md) and | ||||||
| accordingly. | change `<appid>` accordingly. | ||||||
|  |  | ||||||
| ```js | ```js | ||||||
| $J.post( g_strWishlistBaseURL + 'remove/', { | $J.post( g_strWishlistBaseURL + 'remove/', { | ||||||
|   | |||||||
| @@ -24,6 +24,7 @@ The Bluetooth features can be managed by different types of front-ends. | |||||||
|  |  | ||||||
| - `bluetoothctl` is a command-line interface included in the `bluez-utils` | - `bluetoothctl` is a command-line interface included in the `bluez-utils` | ||||||
|   package |   package | ||||||
| - `bluetuith` can be used as a bluetooth manager with a terminal user interface | - `bluetuith` can be used as a bluetooth manager with a | ||||||
|  |   [terminal](/wiki/system_console.md) user interface. | ||||||
|   It is included in a package of the same name, that needs to be installed |   It is included in a package of the same name, that needs to be installed | ||||||
|   before usage. |   before usage. | ||||||
|   | |||||||
| @@ -1,6 +1,7 @@ | |||||||
| # Khal | # Khal | ||||||
|  |  | ||||||
| [Khal](https://github.com/pimutils/khal) is a calendar you can use in your terminal. | [Khal](https://github.com/pimutils/khal) is a calendar you can use in your | ||||||
|  | [terminal](/wiki/system_console.md). | ||||||
| You can sync it with [vdirsyncer](vdirsyncer.md) | You can sync it with [vdirsyncer](vdirsyncer.md) | ||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|   | |||||||
| @@ -1,6 +1,7 @@ | |||||||
| # Khard | # Khard | ||||||
|  |  | ||||||
| [Khard](https://github.com/lucc/khard) is a adressbook that runs in your terminal. | [Khard](https://github.com/lucc/khard) is a adressbook that runs in your | ||||||
|  | [terminal](/wiki/system_console.md). | ||||||
| You can sync it with [vdirsyncer](vdirsyncer.md). | You can sync it with [vdirsyncer](vdirsyncer.md). | ||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|   | |||||||
| @@ -1,6 +1,6 @@ | |||||||
| # NeoMutt | # NeoMutt | ||||||
|  |  | ||||||
| Neomutt is a mail program that runs in your terminal. | Neomutt is a mail program that runs in your [terminal](/wiki/system_console.md). | ||||||
| It can be easily configured using mutt-wizard. | It can be easily configured using mutt-wizard. | ||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|   | |||||||
| @@ -7,7 +7,8 @@ networks by providing options for various configuration. | |||||||
|  |  | ||||||
| NetworkManager can be installed with the `networkmanager` package on most linux | NetworkManager can be installed with the `networkmanager` package on most linux | ||||||
| distributions which provides daemon aswell as `nmcli` a command line interface | distributions which provides daemon aswell as `nmcli` a command line interface | ||||||
| and `nmtui` a terminal user interface for configuration. | and `nmtui` a [terminal](/wiki/system_console.md) user interface for | ||||||
|  | configuration. | ||||||
| Additionally `nm-connection-editor` can be installed for a graphical user | Additionally `nm-connection-editor` can be installed for a graphical user | ||||||
| interface. | interface. | ||||||
|  |  | ||||||
|   | |||||||
| @@ -32,6 +32,6 @@ playerctl previous | |||||||
| ## Using Hotkeys | ## Using Hotkeys | ||||||
|  |  | ||||||
| Hotkeys can be more accessible than typing the commands to start or stop music | Hotkeys can be more accessible than typing the commands to start or stop music | ||||||
| in the terminal. | in the [terminal](/wiki/system_console.md). | ||||||
| With [SXHKD](/wiki/linux/sxhkd.md#setting-a-hotkey) commands from the CLI can | With [SXHKD](/wiki/linux/sxhkd.md#setting-a-hotkey) commands from the CLI can | ||||||
| be set to a hotkey. | be set to a hotkey. | ||||||
|   | |||||||
| @@ -9,7 +9,7 @@ Notable works include `dwm` and `dmenu`. | |||||||
| - dwm is a window manager | - dwm is a window manager | ||||||
| - ii is an IRC client | - ii is an IRC client | ||||||
| - slock is a screen locker | - slock is a screen locker | ||||||
| - st is a terminal | - st is a [terminal](/wiki/system_console.md) | ||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|  |  | ||||||
|   | |||||||
| @@ -1,6 +1,7 @@ | |||||||
| # Todoman | # Todoman | ||||||
|  |  | ||||||
| [todoman](https://github.com/pimutils/todoman) is a todolist you can use in your terminal. | [todoman](https://github.com/pimutils/todoman) is a todolist you can use in your | ||||||
|  | [terminal](/wiki/system_console.md). | ||||||
| You can sync it using [vdirsyncer](vdirsyncer.md) | You can sync it using [vdirsyncer](vdirsyncer.md) | ||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|   | |||||||
| @@ -20,5 +20,5 @@ If you don't have a built-in web interface for your mail-server you need some | |||||||
| software to access your mails. | software to access your mails. | ||||||
| And even if you have it can be useful to keep your mails synced locally on your pc. | And even if you have it can be useful to keep your mails synced locally on your pc. | ||||||
|  |  | ||||||
| - [Neomutt](linux/neomutt.md) is a terminal-based mail client for linux, that | - [Neomutt](linux/neomutt.md) is a [terminal-based](/wiki/system_console.md) | ||||||
| has a simple interface. |   mail client for linux, that has a simple interface. | ||||||
|   | |||||||
| @@ -5,9 +5,9 @@ | |||||||
|  |  | ||||||
| ## Setup | ## Setup | ||||||
|  |  | ||||||
| The software can be setup via [Docker](/wiki/docker.md) with a terminal user | The software can be setup via [Docker](/wiki/docker.md) with a | ||||||
| interface program for nginx and certbot, which is called | [terminal](/wiki/system_console.md) user interface program for nginx and | ||||||
| nginx-certbot-docker-tui or short ncdt. | certbot, which is called nginx-certbot-docker-tui or short ncdt. | ||||||
|  |  | ||||||
| Alternatively the standalone [nginx image](./docker-images/nginx.md) can be | Alternatively the standalone [nginx image](./docker-images/nginx.md) can be | ||||||
| used. | used. | ||||||
|   | |||||||
							
								
								
									
										19
									
								
								wiki/search_engine.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										19
									
								
								wiki/search_engine.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,19 @@ | |||||||
|  | # Search Engine | ||||||
|  |  | ||||||
|  | A search engine is a software that searches and finds web pages given a search | ||||||
|  | term. | ||||||
|  | Search engines are usually set as the start page of a | ||||||
|  | [web browser](/wiki/web_browser.md). | ||||||
|  |  | ||||||
|  | ## Engine Providers | ||||||
|  |  | ||||||
|  | There are various search engines that can be used. | ||||||
|  |  | ||||||
|  | - [Google](https://www.google.com/) is the most used search engine in the world. | ||||||
|  |   Despite that being the case it has questionable privacy standards. | ||||||
|  | - [DuckDuckGo](https://duckduckgo.com/) is a privacy oriented search engine. | ||||||
|  |   For that reason it does not feature personalized search results. | ||||||
|  | - [Whoogle](/wiki/whoogle.md) is a free metasearch engine that can be | ||||||
|  |   self-hosted. | ||||||
|  |   It uses the general layout of the Google search engine. | ||||||
|  | - [Searx](/wiki/searx.md) is a free metasearch engine that can be self-hosted. | ||||||
							
								
								
									
										14
									
								
								wiki/system_console.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										14
									
								
								wiki/system_console.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,14 @@ | |||||||
|  | # System Console | ||||||
|  |  | ||||||
|  | A system console is used for entering data into a computer and communicating | ||||||
|  | with it. | ||||||
|  | It mostly uses a keyboard for input aswell as a screen for displaying results. | ||||||
|  | Additionally a terminal is used. | ||||||
|  |  | ||||||
|  | ## Terminals | ||||||
|  |  | ||||||
|  | The following section lists different terminals. | ||||||
|  |  | ||||||
|  | - [suckless' st](/wiki/linux/suckless.md#programs) is a simple terminal | ||||||
|  |   implementation for [X](/wiki/linux/x_window_system.md) on | ||||||
|  |   [Linux](/wiki/linux/linux.md). | ||||||
							
								
								
									
										10
									
								
								wiki/vnc.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										10
									
								
								wiki/vnc.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,10 @@ | |||||||
|  | # VNC | ||||||
|  |  | ||||||
|  | VNC - short for Virtual Network Computing - is a software used for sharing the | ||||||
|  | desktop of a system. | ||||||
|  | It is based on the Remote Frame Buffer protocoll which is also named RFB. | ||||||
|  |  | ||||||
|  | VNC is especially used for accessing graphical applications or | ||||||
|  | [terminals](/wiki/system_console.md) of a remote server, | ||||||
|  | [dockerized](/wiki/docker.md#dockerize-a-graphical-application) or virtualized | ||||||
|  | program. | ||||||
							
								
								
									
										11
									
								
								wiki/web_browser.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										11
									
								
								wiki/web_browser.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,11 @@ | |||||||
|  | # Web Browser | ||||||
|  |  | ||||||
|  | A web browser is an application that is used for accessing websites. | ||||||
|  | Browsers often use [search engines](/wiki/search_engine.md). | ||||||
|  |  | ||||||
|  | ## Setup | ||||||
|  |  | ||||||
|  | There are various web browsers that are used. | ||||||
|  | This article recommends the usage of [Firefox](/wiki/firefox.md) because it is | ||||||
|  | both widely supported and gives the posibility to configure many things to | ||||||
|  | provide a secure web browser. | ||||||
		Reference in New Issue
	
	Block a user