Deploying FireBack as System Service in Ubuntu Server

FireBack is exported and available for download as binaries for different operating systems, as well as Ubuntu.

It's quite easy to deploy this software on any ubuntu versions, just by downloading and making it a system service.

Step 1: Download the latest version

You can download the application in local bin folder, so it's the appropriate location for the app.

sudo mkdir /usr/local/bin/fireback;
cd /usr/local/bin/fireback; 
sudo wget https://pixelplux.com/fireback-artifacts/fireback-linux-x64;
sudo chmod +x fireback-linux-x64;

Binaries might not be signed. If you need signed version, contact sales.

Step 2: Create your config file.

Binary can start without any configuration, but it will put the database in a temporary file, and it won't start some services. Createa config file, and learn more on Yaml Config page about the available options

sudo nano /usr/local/bin/fireback/config.yml;

and after that, paste these content, or modify based on your app url:

publicServer:
  enabled: true
  host: "localhost"
  port: 4900

database:
   vendor: sqlite
   database: /usr/local/bin/fireback/data.db
smartUI:
  enabled: true
  redirectOnSuccess: http://localhost:3000/auth?exchangeKey=%exchangeKey%

For Mysql connection, change the config of database portion:

database:
  vendor: mysql
  database: db1
  username: root
  password: root
  port: 3306
  host: localhost

Ofcourse, change the database credentials.

Step 2: Create a system service

sudo nano /lib/systemd/system/fireback.service

and inside this file, add:

[Unit]
Description=Fireback Server

[Service]
Environment="CONFIG_PATH=/usr/local/bin/fireback/config.yml"
Type=simple
Restart=always
RestartSec=5s
ExecStart=/usr/local/bin/fireback/fireback-linux-x64

[Install]
WantedBy=multi-user.target

Now that you’ve written the service unit file, start your Fireback web service by running:

sudo service fireback start

To confirm if the service is running, use the following command:

sudo service fireback status

Step 3: Config the database

Fireback automatically creates Sqlite database and a config file in the same directory as the binary file. Go and config the json file for database configuration if you want to connect it to mysql.