Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binhex/arch-preclear
Docker build script for Arch Linux base with Preclear script
https://github.com/binhex/arch-preclear
archlinux docker preclear unraid
Last synced: 23 days ago
JSON representation
Docker build script for Arch Linux base with Preclear script
- Host: GitHub
- URL: https://github.com/binhex/arch-preclear
- Owner: binhex
- License: gpl-3.0
- Created: 2019-08-22T11:59:34.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-22T11:47:49.000Z (4 months ago)
- Last Synced: 2024-10-12T18:58:56.407Z (about 1 month ago)
- Topics: archlinux, docker, preclear, unraid
- Language: Shell
- Homepage:
- Size: 64.5 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**Application**
[Preclear](https://forums.unraid.net/topic/2732-preclear_disksh-a-new-utility-to-burn-in-and-pre-clear-disks-for-quick-add/)
**Description**
A utility to "burn-in" a new disk, before adding it to your array has been requested several times. Also requested is a process to "pre-clear" a hard disk before adding it to your array. When a special "signature" is detected, the lengthy "clearing" step otherwise performed by unRAID is skipped.
The Preclear script was created by [Joe L.](https://forums.unraid.net/topic/2732-preclear_disksh-a-new-utility-to-burn-in-and-pre-clear-disks-for-quick-add/) and later modified by [bjp999](https://forums.unraid.net/topic/30921-unofficial-faster-preclear/), all credit goes to both of these authors for the script.
**Build notes**
IMPORTANT - This is Docker image is specifically for unRAID users ONLY - do NOT attempt to use this utility with other operating systems.
**Usage**
```
docker run -d \
-p 5900:5900 \
-p 6080:6080 \
--name= \
--privileged=true \
-v /boot/config/disk.cfg:/unraid/config/disk.cfg:ro \
-v /boot/config/super.dat:/unraid/config/super.dat:ro \
-v /var/local/emhttp/disks.ini:/unraid/emhttp/disks.ini:ro \
-v /usr/local/sbin/mdcmd:/unraid/mdcmd:ro \
-v /dev/disk/by-id:/unraid/disk/by-id:ro \
-v /boot/config/plugins/dynamix/dynamix.cfg:/unraid/config/plugins/dynamix/dynamix.cfg:ro \
-v /etc/ssmtp/ssmtp.conf:/unraid/ssmtp/ssmtp.conf:ro \
-v :/config \
-v /etc/localtime:/etc/localtime:ro \
-e WEBPAGE_TITLE= \
-e VNC_PASSWORD= \
-e ENABLE_STARTUP_SCRIPTS= \
-e UMASK= \
-e PUID=0 \
-e PGID=0 \
binhex/arch-preclear
```
Please replace all user variables in the above command defined by <> with the correct values.
**Example**
```
docker run -d \
-p 5900:5900 \
-p 6080:6080 \
--name=preclear \
--privileged=true \
-v /boot/config/disk.cfg:/unraid/config/disk.cfg:ro \
-v /boot/config/super.dat:/unraid/config/super.dat:ro \
-v /var/local/emhttp/disks.ini:/unraid/emhttp/disks.ini:ro \
-v /usr/local/sbin/mdcmd:/unraid/mdcmd:ro \
-v /dev/disk/by-id:/unraid/disk/by-id:ro \
-v /boot/config/plugins/dynamix/dynamix.cfg:/unraid/config/plugins/dynamix/dynamix.cfg:ro \
-v /etc/ssmtp/ssmtp.conf:/unraid/ssmtp/ssmtp.conf:ro \
-v /apps/docker/preclear:/config \
-v /etc/localtime:/etc/localtime:ro \
-e WEBPAGE_TITLE=Preclear \
-e VNC_PASSWORD=mypassword \
-e ENABLE_STARTUP_SCRIPTS=yes \
-e UMASK=000 \
-e PUID=0 \
-e PGID=0 \
binhex/arch-preclear
```
If you do specify a password for the web ui via the env var 'VNC_PASSWORD' then it MUST be 6 characters or longer, otherwise it will be ignored.
**Access via web interface (noVNC)**
`http://:/vnc.html?resize=remote&host=&port=&&autoconnect=1`
e.g.:-
`http://192.168.1.10:6080/vnc.html?resize=remote&host=192.168.1.10&port=6080&&autoconnect=1`
**Access via VNC client**
`::`
e.g.:-
`192.168.1.10::5900`
**Notes**
`ENABLE_STARTUP_SCRIPTS` when set to `yes` will allow a user to install additional packages from the official Arch Repository or the Arch User Repository (AUR) via scripts located in the folder `/config/home/scripts/`. A sample script is located at `/config/home/scripts/example-startup-script.sh` with comments to guide the user on script creation.
User ID (PUID) and Group ID (PGID) can be found by issuing the following command for the user you want to run the container as:-
```
id
```
___
If you appreciate my work, then please consider buying me a beer :D
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MM5E27UX6AUU4)
[Documentation](https://github.com/binhex/documentation) | [Support forum](https://forums.unraid.net/topic/83465-support-binhex-preclear/)