netatalk.io

Webmin Module


The official Webmin module for Netatalk was introduced around 2000. It facilitates the administration of the AFP server via a user friendly Web GUI.

As of Netatalk 4.0, the Webmin module is bundled with Netatalk proper. For the old stable versions Netatalk v3 and Netatalk v2 exist, find the source code and release tarballs in the netatalk-webmin Git repository.

The module is tested on Debian, Fedora, and Solaris.

This page is meant to give an overview of the feature set and usage notes of the module. Installation instructions can be found in the module’s README file, and will not be repeated here.

v4 Module

Netatalk v4 combines the best aspects of v3 and v2, so the Webmin module does the same. While building on the solid foundations of the v3 module, it adds the ability to manage AppleTalk services.

Webmin Module screenshot

v3 Module

Netatalk v3 got an entirely rewritten ini-style configuration file format, replacing the legacy format in v2 and earlier. Therefore, the backend of the Webmin module was entirely rewritten from scratch.

The module index is the hub for all of the module’s features. You can see the configured shared volumes, as well as start and stop the netatalk daemons from here.

Webmin Module screenshot

Create or edit a shared volume

Webmin Module screenshot

Create or edit volume presets

Can be used to streamline configuration of multiple volumes at once.

Webmin Module screenshot

Create or edit home shares

Webmin Module screenshot

Modify global server settings

Webmin Module screenshot

v2 Module

The legacy v2 version of the Webmin module allows you to control the AFP server as well as the AppleTalk services.

The module index is the hub for all of the module’s features. You can see the configured shared volumes and virtual servers, as well as start and stop the Netatalk and AppleTalk daemons from here.

Webmin Module screenshot

Create or edit shared volume

Complete support for all volume options are available when creating new or editing shared volumes. Equivalent to editing AppleVolumes.default.

Webmin Module screenshot

Global server settings

All virtual AppleShare server options are available through the GUI. Equivalent to editing afpd.conf.

Webmin Module screenshot

Config editor

An interactive config file editor is also available for manual fine tuning of settings.

Webmin Module screenshot

Common Functions

These functions are identical between the v3 and v2 versions of the module.

Connected user management

Each connected user has its own forked afpd daemon process that is owned by that user. By killing the process, the connected user will be effectively kicked off the server.

Webmin Module screenshot

Server capabilities

The response from asip-status gives you an overview of the addresses and capabilities of the AFP server.

Webmin Module screenshot


This is a mirror of the Netatalk GitHub Wiki. Please visit the original page if you want to correct an error or contribute new contents.

Last updated 2024-12-09