install.md 2.3 KB

Installation

Requirements

Docker

This page should be enough to guide you on installing docker. But here is a quick rundown for GNU+Linux:

# Debian / Trisquel
sudo apt-get install docker docker-engine docker.io containerd runc
# Arch Linux / Parabola
sudo pacman -S docker
# Fedora
sudo dnf install docker-ce docker-ce-cli containerd.io
# Void Linux / Ymir
sudo xbps-install docker

Add yourself to docker group:

sudo usermod -aG docker $USER

Local Tunneling

Install one of these tunneling service to access the Drone UI from an URL generated by these services. It makes it easy to self host without having a server/domain of your own.

pgrok

pgrok is a fork of previously Free Software service ngrok. Download a release and continue:

# Debian / Trisquel
sudo dpkg -i pgrok_*_linux_arm64.deb
# Fedora
sudo dnf install pgrok_*_linux_amd64.rpm
# Arch Linux / Parabola
sudo pacman -S binutils
ar x pgrok_*_linux_arm64.deb data.tar.xz
sudo tar xf data.tar.xz -C /
rm data.tar.xz
# Void Linux / Ymir
sudo xbps-install binutils
ar x pgrok_*_linux_arm64.deb data.tar.xz
sudo tar xf data.tar.xz -C /
rm data.tar.xz

localtunnel

It's easy to install with npm and widely suggested because of it's ease of use. One of the downsides is that the url changes every time you start, so you'll have to change the URL in OAuth Application settings when it changes.

# Debian / Trisquel
sudo apt install nodejs npm
# Fedora
sudo dnf install nodejs
# Arch Linux
sudo pacman -S nodejs
# Void Linux / Ymir
sudo xbps-install nodejs
npm install -g localtunnel

tunnelto

tunnelto which powers tunnelto.dev is written in Rust. Requires you to get an API key from their website and put it in TUNNELTO_API_KEY on config.sh.

To install, download tunnelto-linux.tar.gz from tunnelto releases page, then:

sudo tar xf tunnelto-linux.tar.gz -C /usr/local/bin

Configuration

git clone https://notabug.org/adnan360/droney.git
cd droney
cp -i config.sample.sh config.sh

See Configuration documentation for details on how to edit config.sh.