Skip to content

Manual Compilation

If you prefer to manually compile Termix from source, follow these steps.

Prerequisites

  • Git
  • Node.js (v18 or higher)
  • NPM
  • Docker
  • Docker Compose
  • OpenSSL (required at PATH variable if using https)

Installation Steps

  1. Clone the repository:
bash
git clone https://github.com/LukeGus/Termix.git
cd Termix
  1. Install dependencies and build the project:
bash
npm install
npm run build
  1. Start the application:
bash
npm run preview

TIP

For production environments, we recommend running the website via Nginx. See the Nginx configuration in the Docker directory of the repository.

  1. Start the backend services:
bash
npm run dev:backend

Building from Source

If you want to build Termix from source and create your own Docker image, follow these steps:

Build Steps

  1. Clone the repository:
bash
git clone https://github.com/LukeGus/Termix.git
cd Termix
  1. Install dependencies:
bash
npm install
  1. Build the frontend:
bash
npm run build
  1. Build the Docker image:
bash
docker build -t termix:latest -f docker/Dockerfile .
  1. Create a Docker Compose file to use your built image:
yaml
services:
  termix:
    image: termix:latest
    container_name: termix
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - termix-data:/app/data
    environment:
      PORT: "8080"

volumes:
  termix-data:
    driver: local
  1. Start the container:
bash
docker-compose up -d

Usage

Once compiled and running, Termix will be available at http://localhost:8080 (or whichever port you configured).

Support

If you need help with Termix, you can join the Discord server and visit the support channel. You can also open an issue or open a pull request on the GitHub repo.

Distributed under the Apache License Version 2.0