> 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/file-servers-and-protocols/files-com-agent/linux-installation.md).

# Linux Installation

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

## 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`).

## Agent Download

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.

## Service Installation

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

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

Start the service with:

```bash
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:

```bash
files-agent service stop
```

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

```bash
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 the Linux system uses `systemd`, you can install the Agent by creating a service unit. For another init system, follow that system's service documentation.

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

```ini
[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:

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

Start the service with:

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

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

Stop the service with:

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

Remove the service with:

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