Installation

JustLabel is distributed in two versions – desktop and server The quickest way to start the system is just downloading and running desktop version. This is good point to start if you just want to try if this is product for you, or you have only one workstation to work with the system. Desktop edition is as easy as download and run.

Server edition may require some knowledge of dev-ops techniques to be launched. For details go to Server edition setup guide

Desktop edition installation

Desktop edition is available for Windows, Linux and macOS for Apple Silicon.

  1. Download package dedicated for your OS from https://justlabel.io/#free_tier
  2. Depending on your os:
    • For Windows: Run downloaded installer and run JustLabel using menu start
    • For Linux: Unzip archive and run JustLabel file (you may need to allow for file execution in file properties)
    • For macOS: Install dmg image using drag and drop and run JustLabel from applications menu

Server edition installation

Server edition is distributed via docker image for amd64 architecture. I required MariaDB database to be present. It may be provided as unrelated instance or simply use compose file provided in this tutorial, that wil bring up and configure basic database. We recommend to use Linux based servers for installation.

  1. Make sure that you have the newest docker version installed.
  2. To install docker use tips from official docker website: https://docs.docker.com/engine/install/
  3. Create docker-compose.yml file with the following content(you can modify it to meets your needs, especially in terms of changing secrets):
				
					version: '3.5'
services:
  justlabel-database:
    container_name: justlabel-database
    image: mariadb:10
    restart: unless-stopped
    ports:
      - "13306:3306"
    environment:
      - MARIADB_RANDOM_ROOT_PASSWORD=yes
      - MARIADB_USER=justlabel
      - MARIADB_PASSWORD=R3placeWithSecurePassword!
      - MARIADB_DATABASE=justlabel
    volumes:
      - data-mariadb:/var/lib/mysql
    healthcheck:
    test: "mysql -ujustlabel -pR3placeWithSecurePassword! justlabel -e 'SELECT 1'"
    interval: "5s"
    retries: 12
    networks:
      - justlabel-network
  justlabel:
    container_name: justlabel
    image: justlabel/justlabel:latest-mariadb
    restart: unless-stopped
    environment:
      - DB_HOST=justlabel-database
      - DB_PORT=3306
      - DB_NAME=justlabel
      - DB_USER=justlabel
      - DB_PASSWORD=R3placeWithSecurePassword!
    ports:
      - "5987:5987"
    depends_on:
      - justlabel-database
    networks:
      - justlabel-network

networks:
  justlabel-network:
    driver: bridge
    ipam:
      driver: default

volumes:
  data-mariadb:
				
			
  1. In the same directory run command in system the console(-d parameter will run it in the background):
				
					user@server:~$ docker compose up -d
				
			

Table of contents