The installer has been designed to assist users with creating an instance of RaspAP both quickly and with a great deal of flexibility. The install loader will respond to several command line arguments, or switches, enabling various features, upgrades or even installing from a forked version of RaspAP in another GitHub repository.
The Quick installer has several options for configuring a RaspAP installation. You can get usage notes from your command shell by requesting the installer like so:
curl -sL https://install.raspap.com | bash -s -- --help
-s -- [OPTION] to the Quick Install directive will activate one or more options. These are described below.
The installer may be invoked locally or remotely via
curl. Examples with both cases and various options are given below.
Invoke installer remotely, run non-interactively with option flags:
curl -sL https://install.raspap.com | bash -s -- --yes --openvpn 1 --adblock 0
Invoke remotely, uprgrade an existing install to the Insiders Edition:
curl -sL https://install.raspap.com | bash -s -- --upgrade --insiders
Run locally specifying GitHub repo and branch:
raspbian.sh --repo foo/bar --branch my/branch
Run locally requesting release info:
-y, --yes, --assume-yes
This option enables unattended installations, such that the installer assumes "yes" as an answer to all user prompts. This behavior is identical to how the same option with the
apt-get package handler works.
Used with the
--yes option above, this sets the OpenVPN install option (
0 = don't install OpenVPN). Given that OpenVPN support is an optional extra, this enables an unattended setup without installing it.
Used with the
--yes option above, this sets the Ad Blocking install option (
0 = don't install Adblock). Given that Adblock support is an optional extra, this enables an unattended setup without installing it.
-c, --cert, --certificate
This option installs an SSL certificate with
mkcert and configures lighttpd for HTTPS support. It does not (re)install RaspAP. Details are provided here.
-r, --repo, --repository
If you have forked this project to your own GitHub repo, this option lets you override the default GitHub repo (
RaspAP/raspap-webgui) used to install RaspAP. An alternate repository name is a required parameter.
Similarly, this option overrides the default git branch (
master). This is useful if you have created a feature branch (
my-feature) and wish to perform an installation using the Quick Installer. An alternate branch name is a required parameter.
An example combining the
branch options is given below:
curl -sL https://install.raspap.com | bash -s -- --repo foo/bar --branch my-feature
Specify a GitHub token to access a private repository.
Upgrades an existing installation to the latest release version.
Installs from the Insiders Edition (
Queries the Github API, outputs the latest RaspAP release version and exits.
Outputs these usage notes and exits.