Systemd Service

If you wish to install either FileFlows Server or FileFlows node as as systemd service. Follow this guide.

First you need to have "dotnet" available to sudo and in the path variable. This is needed as you have to use sudo to install the service, and the systemd file will use "dotnet" to launch FileFlows.

Installation

Server

To install FileFlows server as a systemd service run the following:

cd Server
sudo dotnet FileFlows.Server.dll --systemd

Or to install as a root user

cd Server
sudo dotnet FileFlows.Server.dll --systemd root

Node

To install FileFlows Node, it is recommended that you first run the Node manually to create the configuration file which include the URL of the server

cd Node
dotnet FileFlows.Node.dll

This will create a JSON configuration file /Data/node.config

{
  "ServerUrl": "",
  "AccessToken": "",
  "HostName": "machine-name"
}

Update the "ServerURL" with the URL to your FileFlows Server, for example

{
  "ServerUrl": "http://192.168.1.100:19200/",
  "AccessToken": "",
  "HostName": "machine-name"
}

Save the file.

Then install the systemd service with the following command

sudo dotnet FileFlows.Node.dll --systemd

Or to install as a root user

sudo dotnet FileFlows.Node.dll --systemd --root

---

Check The Status

Server

To check the status of the FileFlows Server run

sudo systemctl status fileflows.service

Node

And to check the status of the FileFlows Node run

sudo systemctl status fileflows-node.service

---

Uninstall

Server

To uninstall the Server run ```bash cd Server sudo dotnet FileFlows.Server.dll --systemd --uninstall ``` Or to uninstall manually

sudo systemctl stop fileflows
sudo systemctl disable fileflows
sudo rm /etc/systemd/system/fileflows.service
sudo systemctl daemon-reload
sudo systemctl reset-failed

Node

To uninstall the Node run

cd Node
sudo dotnet FileFlows.Node.dll --systemd --uninstall

Or to uninstall manually

sudo systemctl stop fileflows-node
sudo systemctl disable fileflows-node
sudo rm /etc/systemd/system/fileflows-node.service
sudo systemctl daemon-reload
sudo systemctl reset-failed

---

FAQ

Question: I am getting the following error when trying to install the service "sudo: dotnet: command not found"

Answer: This means sudo cannot access dotnet, you can use whereis to find dotnet then include the full path

For example,

> whereis dotnet
> dotnet: /home/user/.dotnet/dotnet
> sudo /home/user/.dotnet/dotnet FileFlows.Server.dll --systemd

---

Question: I am getting an error saying dotnet cannot be found

Answer: If dotnet is not available in the PATH variable, you can modify the /etc/systemd/system/fileflows.service or /etc/systemd/system/fileflows-node.service and replace "dotnet" with the full path to dotnet. You can find dotnet by running

whereis dotnet

For example,

> whereis dotnet
> dotnet: /home/user/.dotnet/dotnet
> sudo nano /etc/systemd/system/fileflows.service

And replace "dotnet" with /home/user/.dotnet/dotnet