Installation

Picking a Server OS

Airlink runs on a wide range of operating systems, so pick whichever you are most comfortable using.

Operating System	Version	Supported	Notes
Ubuntu	24.04	✅	Documentation written assuming Ubuntu 24.04 as the OS.
	22.04	✅
CentOS	7	✅	Extra repos are required.
	8	✅	Note that CentOS 8 is EOL. Use Rocky or Alma Linux.
Debian	11	✅
	12	✅
Windows	11	✅
	10	✅
macOS	10.15+	✅

Dependencies

Node.js v18 and higher (Nodejs v22 recommended).

Example Dependency Installation

The commands below are simply an example of how you might install these dependencies on Ubuntu 24.04. Please consult with your operating system's package manager to determine the correct packages to install.

# Ubuntu/Debian
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_16.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

sudo apt update
sudo apt install -y nodejs git

Installation

The following commands will download the Airlink Panel into /etc/airlink and use npm to install the required packages:

cd /etc
git clone https://github.com/airlinklabs/panel
cd airlink
npm install
cp example.env .env
npm run migrate:dev
npm run build

Seed

You'll need to seed the images otherwise you will not be able to deploy servers unless you upload your own images.

npm run seed

Setup Complete

All you need to do now is start Airlink:

npm run start

Your Panel will now be accessible from port 3001 (unless you changed it in .env).