Networking

How to add users to shares with the TurnKey Linux FileServer appliance

For a quick, easy, and free file-sharing appliance, look no further than TurnKey Linux. Learn how to set up users and add them to shares.

sambahero.jpg
Image: Jack Wallen

TurnKey Linux offers handy virtual appliances, ranging from a basic LAMP stack to an LDAP appliance and much more. If you need to spin up a file-sharing appliance in a hurry, the TurnKey Linux file server cannot be beat. By employing basic, off-the-shelf hardware or a virtual machine, you can get a solid SMB, SFTP, NFS, WebDAV, and rsync file server running in no time.

Getting a TurnKey Linux appliance up and running is simple. Follow these steps.

  1. Download the ISO.
  2. Fire up your virtual machine tool (I prefer VirtualBox).
  3. Create a new virtual machine.
  4. Attach the ISO to the machine.
  5. Make sure to change the networking to bridged (in the case of VirtualBox).
  6. Fire up the appliance.

In the case of the file server appliance, you'll want to log into the Webmin console at the address https://IP_OF_SERVER:12321 (IP_OF_SERVER is the actual address displayed on the virtual appliance screen - Figure A).

Figure A

Figure A
Image: Jack Wallen
All the addresses you need in one location.

When you log into the Webmin console, the user is root, and there is no password—you'll want to immediately change that. Click System | Change Passwords, click the root user, type/verify the new password, and then click Change. With that out of the way, we can create a new user.

SEE: Photos: 10 laptops for Linux lovers

Creating a user

There are two steps to creating a user for shares. The first step is to create the user by going to System | Users And Groups. In the new window (Figure B), click Create A New User.

Figure B

Figure B
Image: Jack Wallen
Creating a new user from within the Webmin console

The new user screen is simple—just answer the questions (make sure to set a password) and click Create. There are a number of questions offered, but most of the defaults will work fine. At this point, you probably haven't created any groups yet, so it's unlikely that you'll need to add the new user to a group.

Note: I highly recommend creating groups (which is done in similar fashion to creating users), adding users to the newly created groups, and then associating a group to the share. This makes it much easier to manage, as opposed to having to always add multiple users to a share.

Once the new user is created, you have to convert the user to a Samba user. Without taking care of this step, the user will not be able to authenticate to any shares on the system. To do this, follow these steps.

  1. Log into the TurnKey File Server as root.
  2. Click Servers | Samba Windows File Sharing.
  3. Scroll down and click Convert Users.
  4. Type in the name of the user to convert* (Figure C).
  5. Click Convert Users.

* If you need to convert multiple users, you can do so by entering a UID (User ID) range (found on the Users & Groups page) like so: 1000-1011.

Figure C

Figure C
Image: Jack Wallen
Converting a current user to a Samba user

Any Samba user can access the default shares on the File Server system (out of the box, there is only one shared folder called storage).

Creating new shares

  1. Log into the TurnKey File Server Webmin console as root.
  2. Go to Samba Windows File Sharing.
  3. Click Create A New File Share.
  4. Give the share a name (Figure D).
  5. Enter the path for the directory to be shared (I recommend placing the new share in /srv, so it's easily viewable when browsing).
  6. Select if the share needs to belong to a specific owner or group.
  7. Enter a comment (optional).
  8. Click Create.

Figure D

Figure D
Image: Jack Wallen
Creating a new share on the system

After you create the share, more options will be available. Click the share in the File Share listing and then click Security and Access Control. In this window, you can set more granular security controls, deny/allow hosts, and more.

Connecting

The way you connect to the share will depend upon the platform you use. From a standard Linux file manager, I can go to smb://IP_OF_SERVER (IP_OF_SERVER is the server's actual name) and enter the credentials of a Samba user on the TurnKey Linux file server system, and I'll be presented with a listing of the shares available to that user (Figure E).

Figure E

Figure E
Image: Jack Wallen
elementary OS Loki ready to make use of the Samba shares.

Make it yours

There's much more to the TurnKey Linux FileServer appliance than simple file sharing. Dig into the Webmin console, poke around, and see just how much more you can get out of this incredibly easy to use file-sharing appliance. You'll be surprised at how well it will serve you.

Also see

About Jack Wallen

Jack Wallen is an award-winning writer for TechRepublic and Linux.com. He’s an avid promoter of open source and the voice of The Android Expert. For more news about Jack Wallen, visit his website jackwallen.com.

Editor's Picks

Free Newsletters, In your Inbox