# Setup on Linux

### The short one-liner

If you are not interested in a detailed overview and explanation, here's a one-line shell command that will:

1. Download the current (latest release) version of the installation archive into a temporary folder
2. Extract it and run the CLI setup for you via `sudo` which will **install** the software or **automatically update** it to the latest release if it's already installed in your system

##### For X86-64/AMD64 architecture

If you prefer <span style="background-color: rgb(251, 238, 184);">wget</span>:

```bash
wget -nv -O setup.sh https://dl.syncplify.com/ss-setup-linux-x64w.sh && sudo sh setup.sh
```

If you prefer <span style="background-color: rgb(251, 238, 184);">curl</span>:

```bash
curl -fsS -o setup.sh https://dl.syncplify.com/ss-setup-linux-x64c.sh && sudo sh setup.sh
```

##### For ARM architecture

If you prefer <span style="background-color: rgb(251, 238, 184);">wget</span>:

```bash
wget -nv -O setup.sh https://dl.syncplify.com/ss-setup-linux-armw.sh && sudo sh setup.sh
```

If you prefer <span style="background-color: rgb(251, 238, 184);">curl</span>:

```bash
curl -fsS -o setup.sh https://dl.syncplify.com/ss-setup-linux-armc.sh && sudo sh setup.sh
```

### Detailed overview and explanation

The following video shows how to install Syncplify Server! on a Linux operating system:

<iframe allowfullscreen="allowfullscreen" height="435" src="https://www.youtube.com/embed/fL8mfStSRNs" style="width: 800px; height: 447px;" width="777"></iframe>

First of all you'll need to [download the most recent version of our software from our website](https://syngo.to/download). After that, in order to extract it and to install it, here's a handy *copy-pastable* list of the two commands you'll need.

To extract the downloaded archive:

```bash
tar -xvf name_of_downloaded_targz_archive.tar.gz
```

Then to begin installing or updating the software:

```bash
sudo ./ss-setup install
```

At the end of this phase, a URL will be shown to you. Simply open it in a browser to continue with the rest of the setup process.

[![CLI install on Linux](https://kb.syncplify.com/uploads/images/gallery/2025-10/ss7linux.png)](https://kb.syncplify.com/uploads/images/gallery/2024-08/bu7image.png)

<p class="callout info">Be careful, the URL references localhost (127.0.0.1) but if you're using a browser on a different computer you will have to change 127.0.0.1 into the current IP address of the machine where you just installed Syncplify Server! on.</p>

##### How to uninstall

To make uninstallation easier, the installer copies the `ss6-setup` executable to your `/usr/bin` directory. Therefore, in order to uninstall Syncplify Server! you can simply open a terminal window anywhere, and type:

```bash
sudo ss-setup uninstall
```

After that, if you also want to remove the uninstaller, you may (optionally) want to do this, too:

```bash
sudo rm /usr/bin/ss-setup
```

##### How to update/upgrade

When the CLI installer is invoked with the `install` verb, it will automatically try to determine whether the software is already installed on the system, and - if that is the case - perform an update/upgrade rather than a new install.

There is, however, a way to force the CLI installer to perform an update/upgrade, when you already know that this is the case. You can simply add the `--update` flag to the install verb, like this:

```bash
sudo ./ss-setup install --update
```

##### And, just in case... you can also do a "repair"

Should anything happen, you can always use the same `ss-setup` you downloaded and extracted, to "repair" your currently deployed executable and back-end DB configuration, like this:

```bash
sudo ./ss-setup install --repair
```

##### More useful command-line flags

There are a couple additional command-line flags that you may want or need to use occasionally. Both of them are intended to be used in conjunction with the `install` verb.

<table border="1" id="bkmrk-flag-purpose-of-the-" style="width: 100%;"><colgroup><col style="width: 16.3116%;"></col><col style="width: 83.6884%;"></col></colgroup><tbody><tr><td>**Flag**</td><td>**Purpose of the flag**</td></tr><tr><td>`--trace`</td><td>Enables trace-level logging for the installation process. This will produce a larger and more detailed installation log, useful to identify the cause of possible installation issues.</td></tr><tr><td>`--norollback`</td><td>Typically, should something go wrong during installation, a rollback operation is performed, to leave your system unchanged. This flag disables such rollback, so that your system remains partially modified even after a failed installation. This is useful in some cases for debugging.</td></tr></tbody></table>

That's it. :)