This plugin is an extension to the Cockpit Project. It allows you to manage your Samba shares through the Cockpit Project user interface.
This plugin is very rough around the edges. It's written in a short amount of time, by someone that has not coded in a very long time and is not familiar with the structure and internal workings of the Cockpit Project GUI. However, it does seem to do what I want it to do.
If you want to improve some pieces of code, or test it, just let me know, or request a merge of your code. I am more than happy to test your changes and merge them in. The HTML code can use a serious cleanup though.
Use this plugin at your own risk.
Compatibility of older versions is not guaranteed once the version is end of lifecycle. This plugin is tested on:
| os | version cockpit | version samba | test date | notes |
|---|---|---|---|---|
| Centos 7 | 195.1 | 4.9.1 | 2020-03-29 | |
| Ubuntu 16.04 | 178-1 | 4.3.11 | 2020-03-28 | |
| Ubuntu 18.04 | 164-1 | 4.7.6 | 2020-03-28 | |
| Ubuntu 19.10 | 202.1-1 | 4.10.7 | 2020-03-28 | |
| Debian 9.1 (stretch) | 188-1 | 4.5.16 | 2020-03-28 | backports enabled |
| Debian 10 (buster) | 188-1 | 4.9.5 | 2020-03-28 | |
| Raspbian Buster (2019-06-20) (Debian 10) | 196-1 | 4.9.11 | 2019-07-23 | unstable version (see install notes) |
| Fedora 31 | 215 | 4.11.7 | 2020-03-28 |
You will need Samba installed. (The automatic install script will check this.)
sudo apt-get install samba
As this is a Cockpit plugin, you will need that as well. (The automatic install script will check this.)
sudo apt-get install cockpit
On Ubuntu 18.04 LTS you need to provide your sudo password at all times. This seems to be a problem for Cockpit. To disable this you can create an additional file in the '/etc/sudoers.d/' folder to allow this.
sudo sh -c 'echo "$(logname) ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/cockpit-smb'
Or if you want to create these yourself:
sudo nano /etc/sudoers.d/cockpit-smb
Add the following line:
$USER ALL=(ALL) NOPASSWD: ALL
When I was looking at the Raspberry Pi 4, I noticed that the base operating system of Raspbian is bumped to Debian Buster. By default the Project Cockpit version is still 188-1 (July 2019), installing this version will break Raspbian. Version 196-1 will work, but at the moment of writing this version is still only found in unstable / testing.
To enable this version add the following line to the repository and update.
sudo sh -c 'echo "deb http://ftp.it.debian.org/debian unstable main contrib non-free" >> /etc/apt/sources.list'
sudo apt update
If you recieve an error about keys, you can request the keys from pgpkeys.mit.edu.
gpg --keyserver pgpkeys.mit.edu --recv-key 04EE7237B7D453EC
gpg -a --export 04EE7237B7D453EC | sudo apt-key add -
To verify that you will install the correct version, you can query the cache policy.
apt-cache policy cockpit
This should show version 198-1 as being a candidate to be installed.
pi@raspberrypi:~ $ apt-cache policy cockpit
cockpit:
Installed: (none)
Candidate: 198-1
Version table:
198-1 500
500 http://ftp.it.debian.org/debian unstable/main armhf Packages
188-1 500
500 http://raspbian.raspberrypi.org/raspbian buster/main armhf Packages
If the version works out, you can install cockpit.
sudo apt install cockpit
Just run the following command to let a script to download the files and install the software. This method of installing is recommended. The automatic install script will figure out if you are running a previous version and which version to apply. As Project Cockpit moves pretty fast, there is a huge version gap between operating systems.
wget -O - https://raw.githubusercontent.com/enira/cockpit-smb-plugin/master/install.sh | sudo bash
Create the Cockpit plugin folder and download the code. The manual install only works with the last tested version of Project Cockpit.
sudo mkdir /usr/share/cockpit/smb
sudo wget https://raw.githubusercontent.com/enira/cockpit-smb-plugin/master/index.html -O /usr/share/cockpit/smb/index.html
sudo wget https://raw.githubusercontent.com/enira/cockpit-smb-plugin/master/manifest.json -O /usr/share/cockpit/smb/manifest.json
sudo wget https://raw.githubusercontent.com/enira/cockpit-smb-plugin/master/smb.js -O /usr/share/cockpit/smb/smb.js
Versions: 1.x: Older user interface 2.x: Compatible with patterfly4
Simple, it's GNU General Public License v2.1