> For the complete documentation index, see [llms.txt](https://moverdocs.files.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moverdocs.files.com/connections/any-server-with-files.com-agent/installing-files.com-agent-on-linux.md).

# Installing Files.com Agent on Linux

Running the Files.com Agent as a system service starts it automatically at boot and keeps it running independently of user logins.

## Configure the Root Path

Before you install the Agent as a service, make sure that the `root` setting in the configuration file uses either a local drive path (such as `/path/to/folder`) or a path to an accessible mounted network drive (such as `/mnt/path/to/folder`).

## Download the Agent

Download the agent executable for your system from the [official download location](https://filescorp.hosted-by-files.com/builds/files-agent-server/latest). Choose the version that matches your architecture and operating system and save it to the same location as your configuration file on the host system.

## Install the Agent

To install the Agent as a service on a Linux system, run the following command:

```
files-agent service install --user-service=false \
  --config /path/to/files_agent_config.toml
```

Start the service with:

```
files-agent service start
```

If you modify the configuration file, stop the service, make your updates, and then restart it.

To stop the service, use:

```
files-agent service stop
```

When you're ready to remove the Agent service, run:

```
files-agent service uninstall --user-service=false
```

## Optional `systemd` Installation <a href="#alternative-installation-method-for-linux" id="alternative-installation-method-for-linux"></a>

If your Linux system uses the [`systemd`](https://en.wikipedia.org/wiki/Systemd) [init system](https://en.wikipedia.org/wiki/Init), you can install the Agent service by creating a service file. For Linux variants that use another init system, refer to the system's init documentation.

Create a file at `/lib/systemd/system/files-agent.service` with the following content:

```
[Unit]
Description=Files.com Agent v2
ConditionFileIsExecutable=/usr/bin/files-agent

[Service]
StartLimitInterval=5
StartLimitBurst=10
ExecStart=/usr/bin/files-agent "start" "--config" "/path/to/files_agent_config.toml" "--log_file" "/path/to/files-agent.log"
Restart=always
RestartSec=60

[Install]
WantedBy=multi-user.target
```

Replace the `ExecStart` paths (config file and log file) with the correct locations for your configuration and log files.

After creating the service file, install and enable it using:

```
sudo systemctl enable files-agent
```

Start the service with:

```
sudo systemctl start files-agent
```

To change the configuration, stop the service, edit the configuration file, then restart the service.

Stop the service with:

```
sudo systemctl stop files-agent
```

Remove the service with:

```
sudo systemctl disable files-agent
```