Quick Installation


First, please make sure that you checked out the Requirements before you start with the installation.

Sign Up

To install CrossBox you need to have a valid CrossBox.io account and an active license.

Single Server Setup

Here we will show you how to install CrossBox on a single server.

Multiple Server Setup

If you plan to install CrossBox on multiple servers, please head out to our CrossBox Cluster documentation to learn how to create a master-slave cluster.

Installing in 5 Easy Steps


SSH into your server and run the following command as root:

sh <(curl https://cdn.crossbox.io/install.sh || wget -O - https://cdn.crossbox.io/install.sh)

Then proceed to log in with your CrossBox.io account:


After a successful login, you'll find the URL that you can now use to start the installation via your web browser:



Open your favorite web browser and paste the URL you copied


Click your way through

Almost everything is already pre-populated for you and the entire process takes about ten minutes or often less, depending on your server's performance.

Detailed Help

If you're not sure what to enter in a certain field during the installation, just click on the "Learn more" link which is displayed beneath it:

By clicking it, you'll be taken directly to that option's more detailed documentation.


Start the installation

After you click the "Install" button, CrossBox will start setting everything up. You can track the progress in real-time as shown below:


Finish the installation

After the installation finishes successfully, you'll see a link which leads you to your CrossBox App.

You can now log in as admin to manage your installation.

To create users, depending on the type of installation, you should get familiar with: