netatalk.io

Webmin Module


Since 2000, Netatalk has distributed an official Webmin module for facilitating the administration of the AFP server via a user friendly Web GUI.

At the time of writing, a maintained module for the latest stable Netatalk v3 exists, as well as a legacy module for Netatalk v2. Find the source code and release tarballs for both in the netatalk-webmin Git repository.

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 respective README file, and will not be repeated here.

v3 Module

Netatalk v3 got an entirely rewritten ini-style configuration file format, and therefore the Webmin module was almost 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

Note: A subset of commonly used settings are exposed in the GUI.

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

The most commonly used 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, including the config files not covered above.

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-04-13