Skip to main content

Installation on Linux Server (Basic)

Following documents are the basic installation step to install Bookings ONE on a Linux Server hosting on a single PC / Virtual machine.

All the component include database will be bundled and setup by the docker file.

If you would like to install server and database separately, please refer to Install on Linux Server (Advanced)

Prerequisites
  • Linux environment that support Docker, while most of the Linux distributions (such as Redhat, CentOS, Ubuntu, Oracle Linux, etc..) will support Docker.
  • Install Docker Engine based on the Linux OS of your environment, you may follow the official Guideline .
  • Install Docker Compose. You should choose linux Standalone binary on the Linux OS, you may follow the official Guideline.
  • a Valid SSL Certificate
info

To confirm if Docker Engine is installed correctly, use command sudo docker images

To confirm if Docker Compose is installed successfully, use command sudo docker-compose version

tip

Making docker auto start when the server restart will make the maintenance easier, use following command (Reference)

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

Setup Procedure​

  1. Download the installation script from Link

  2. Unzip the file the the root folder /bookings-one

  3. Download and put the Bookings ONE Server image bookings-one.tar into the folder /bookings-one

caution

Bookings ONE Server image do not have direct download link. If you want to have the Bookings ONE Server Image for installation, Please contact ONES Software

  1. Replace your SSL Certificate to the one in directory /bookings-one/certificate/bookings-one.pfx, you must keep the name as bookings-one.pfx

  2. Open the docker-compose.yml:

    1. Change the ServerUrl https://localhost to your server address
    2. Change the timezone to your time zone name
    3. Change the ASPNETCORE_Kestrel__Certificates__Default__Password to your certificate password

  3. Open Terminal, run cd /bookings-one

  4. Run command sudo docker load --input ./bookings-one.tar

  5. Run command sudo docker-compose up -d

  6. The startup will take around 2-3 minutes. And you may access the console by https://localhost / Your server address once it complete

Update Bookings ONE Server​

  1. Download the latest Bookings ONE Server image into /bookings-one
  2. Open PowerShell in /bookings-one
  3. Stop Bookings ONE: run command sudo docker-compose down
  4. Load the latest Bookings ONE Server image: run command docker load --input ./bookings-one.tar
  5. Update and start Bookings ONE: run command sudo docker-compose up -d

How to renew the SSL certificate if it is going to expire?​

Go to the original certificate location, replace the existing pfx file with new .pfx file, default path in /bookings-one/certificate/bookings-one.pfx

If the password of pfx changed the existing docker-compose.yml file, change the field ASPNETCORE_Kestrel__Certificates__Default__Password to new password.

Open terminal and run the following command:

cd /bookings-one
sudo docker-compose down
sudo docker-compose up -d

How to handle when database password changed?​

Open the existing docker-compose.yml file, change the existing password to new password. Open powershell and run the following command:

cd /bookings-one
sudo docker-compose down
sudo docker-compose up -d