===========
fuss-server
===========

-----------------------
configure a FUSS server
-----------------------

:Date: 2025-08-05
:Version: 13.0
:Manual section: 8

SYNOPSIS
--------

fuss-server [-h] [--wifi-guest] [--wifi-devices]
            {create,upgrade,purge,reconfigure,test} ...

DESCRIPTION
-----------

This manual page briefly documents the fuss-server command.

COMMONLY USED COMMANDS
----------------------

create
   Get config variables then setup all services of the FUSS server
upgrade
   Upgrade services configuration of an existing FUSS server.
purge
   Purge all files needed to reset a FUSS server for a clean use of create
test
   Test the configuration of a FUSS server.
reconfigure
   Recreate or modify the config variables file for a FUSS server.

   -b, --bootstrap
      Delete all current configuration and start with a new empty file
   -f CONFIGURATION_FILE, --configuration-file CONFIGURATION_FILE
      Use a different configuration file (for testing)

Common options for the ``create`` and ``reconfigure`` commands:

   --wifi-guest
     Also setup a guest network
   --wifi-devices
     Also setup a devices network


WARNING
-------

The reconfigure command is for specialist use only. Only certain changes made
to configurations are supported for subsequent correct application of the
create command, and also so some additional actions may be required. Use only
if you know what you are doing.

More details on what can be changed and how are at
https://fuss-tech-guide.readthedocs.io/it/latest/server/comando_fuss_server.html#modifica-delle-configurazioni

COPYRIGHT
---------

Copyright © 2006-2026 The Fuss Project

AUTHORS
-------

Simone Piccardi piccardi@truelite.it
Elena Grandi elena@truelite.it
Christopher R. Gabriel cgabriel@truelite.it

FILES
-----

/etc/fuss-server/fuss-server.yaml
/etc/fuss-server/*

.. Build the manpage with rst2man fuss-server.8.rst > fuss-server.8
   See also
   http://docutils.sourceforge.net/sandbox/manpage-writer/rst2man.txt
