149 lines
3.5 KiB
Markdown
149 lines
3.5 KiB
Markdown
---
|
|
title: "Install"
|
|
description: "Rclone Installation"
|
|
date: "2016-03-28"
|
|
---
|
|
|
|
# Install #
|
|
|
|
Rclone is a Go program and comes as a single binary file.
|
|
|
|
## Quickstart ##
|
|
|
|
* [Download](/downloads/) the relevant binary.
|
|
* Unpack and the `rclone` binary.
|
|
* Run `rclone config` to setup. See [rclone config docs](/docs/) for more details.
|
|
|
|
See below for some expanded Linux / macOS instructions.
|
|
|
|
See the [Usage section](/docs/) of the docs for how to use rclone, or
|
|
run `rclone -h`.
|
|
|
|
## Linux installation from precompiled binary ##
|
|
|
|
Fetch and unpack
|
|
|
|
curl -O https://downloads.rclone.org/rclone-current-linux-amd64.zip
|
|
unzip rclone-current-linux-amd64.zip
|
|
cd rclone-*-linux-amd64
|
|
|
|
Copy binary file
|
|
|
|
sudo cp rclone /usr/bin/
|
|
sudo chown root:root /usr/bin/rclone
|
|
sudo chmod 755 /usr/bin/rclone
|
|
|
|
Install manpage
|
|
|
|
sudo mkdir -p /usr/local/share/man/man1
|
|
sudo cp rclone.1 /usr/local/share/man/man1/
|
|
sudo mandb
|
|
|
|
Run `rclone config` to setup. See [rclone config docs](/docs/) for more details.
|
|
|
|
rclone config
|
|
|
|
## macOS installation from precompiled binary ##
|
|
|
|
Download the latest version of rclone.
|
|
|
|
cd && curl -O https://downloads.rclone.org/rclone-current-osx-amd64.zip
|
|
|
|
Unzip the download and cd to the extracted folder.
|
|
|
|
unzip -a rclone-current-osx-amd64.zip && cd rclone-*-osx-amd64
|
|
|
|
Move rclone to your $PATH. You will be prompted for your password.
|
|
|
|
sudo mv rclone /usr/local/bin/
|
|
|
|
Remove the leftover files.
|
|
|
|
cd .. && rm -rf rclone-*-osx-amd64 rclone-current-osx-amd64.zip
|
|
|
|
Run `rclone config` to setup. See [rclone config docs](/docs/) for more details.
|
|
|
|
rclone config
|
|
|
|
## Install from source ##
|
|
|
|
Make sure you have at least [Go](https://golang.org/) 1.6 installed.
|
|
Make sure your `GOPATH` is set, then:
|
|
|
|
go get -u -v github.com/ncw/rclone
|
|
|
|
and this will build the binary in `$GOPATH/bin`. If you have built
|
|
rclone before then you will want to update its dependencies first with
|
|
this
|
|
|
|
go get -u -v github.com/ncw/rclone/...
|
|
|
|
## Installation with Ansible ##
|
|
|
|
This can be done with [Stefan Weichinger's ansible
|
|
role](https://github.com/stefangweichinger/ansible-rclone).
|
|
|
|
Instructions
|
|
|
|
1. `git clone https://github.com/stefangweichinger/ansible-rclone.git` into your local roles-directory
|
|
2. add the role to the hosts you want rclone installed to:
|
|
|
|
```
|
|
- hosts: rclone-hosts
|
|
roles:
|
|
- rclone
|
|
```
|
|
|
|
## Installation with snap ##
|
|
|
|
### Quickstart ###
|
|
|
|
* install Snapd on your distro using the instructions below
|
|
* sudo snap install rclone --classic
|
|
* Run `rclone config` to setup. See [rclone config docs](/docs/) for more details.
|
|
|
|
See below for how to install snapd if it isn't already installed
|
|
|
|
#### Arch ####
|
|
|
|
sudo pacman -S snapd
|
|
|
|
enable the snapd systemd service:
|
|
|
|
sudo systemctl enable --now snapd.socket
|
|
|
|
#### Debian / Ubuntu ####
|
|
|
|
sudo apt install snapd
|
|
|
|
#### Fedora ####
|
|
|
|
sudo dnf copr enable zyga/snapcore
|
|
sudo dnf install snapd
|
|
|
|
enable the snapd systemd service:
|
|
|
|
sudo systemctl enable --now snapd.service
|
|
|
|
SELinux support is in beta, so currently:
|
|
|
|
sudo setenforce 0
|
|
|
|
to persist, edit `/etc/selinux/config` to set `SELINUX=permissive` and reboot.
|
|
|
|
#### Gentoo ####
|
|
|
|
Install the [gentoo-snappy overlay](https://github.com/zyga/gentoo-snappy).
|
|
|
|
#### OpenEmbedded/Yocto ####
|
|
|
|
Install the [snap meta layer](https://github.com/morphis/meta-snappy/blob/master/README.md).
|
|
|
|
#### openSUSE ####
|
|
|
|
sudo zypper addrepo https://download.opensuse.org/repositories/system:/snappy/openSUSE_Leap_42.2/ snappy
|
|
sudo zypper install snapd
|
|
|
|
#### OpenWrt ####
|
|
|
|
Enable the snap-openwrt feed.
|