Skip to content

Editing Systemd Units

Muppy provides complete editing features for Systemd Service Units.

Muppy uses these features to manage most of the services it installs (Traefik, Code Server, pglookout, Odoo, ...).

Muppy supports 2 workflows on Unit files:

  • Workflow for creating a Unit file from a Muppy Template file
  • Workflow for modifying an existing Unit file

Creation Workflow

This is the workflow Muppy uses to manage the services it installs. It is made up of the following steps:

  • Create a Systemd Units by providing the Host and Unit Name.
  • In the Configuration tab:
    • In the Unit file Template group, select the Systemd Default Unit File - Muppy template or a derivative.
    • Click the Select template button button
    • Enter the parameters of the systemd options group
    • Click the Generate Unit File button button so that Muppy generates the content of the Unit File.
  • In the Unit File tab,
    • Click the Upload Unit File button button so that Muppy uploads the content of the Unit File to the location defined by Unit File Path.
    • Click the Enable service button button if you want the service to start when the Host boots.
  • Use the 4 Unit control buttons buttons to control the Systemd Unit.

Modification Workflow

The objective - in the long run - of this workflow is to allow an existing Unit File to be managed through the Muppy interface by following these steps:

  • Import a System Unit with the Wizard as described in Import Systemd Units Wizard
  • Open the Service Unit in edit mode
  • In the Unit File tab,
    • Click the Download Unit File button button; Muppy will download the Unit File from the location defined by Unit File Path and display its content in Unit File Content.
    • Modify the content of the Unit File Content field
    • Click the Upload Unit File button button so that Muppy uploads the content of the Unit File to the location defined by Unit File Path.
    • Click the Daemon reload button button so that the system takes the changes into account

Info

You can also generate the content of the Unit File using the variables of the configuration group and a specific Template file, as described in the previous paragraph.