Skip to content

Deploying the nClean server ​

WARNING

Deploying the nClean server on Windows is not supported, I highly recommend using a Linux-based server for production deployments AND using Docker.

Bare metal Linux installation ​

Python requirements

nClean requires Python 3.10 or higher, please install it using the package manager for your distro.

  1. Clone the nClean repository from Codeberg
bash
git clone https://codeberg.org/nxr/nClean.git
cd nClean
  1. Install uv

uv installation method

I recommend installing uv from your package manager instead of running the script below

bash
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Install the dependencies

TIP

Please adjust the activate file to the shell you're currently using!

bash
uv venv WebUI
cd WebUI
source bin/activate
uv pip install -r requirements.txt
  1. Start the gunicorn server

WARNING

Gunicorn isn't available on Windows, please use WSL or a Linux-based server.

bash
uv run gunicorn -w 4 -b 0.0.0.0:5002 main:app

Deploying in Docker ​

  1. Clone the nClean repository from Codeberg
bash
git clone https://codeberg.org/nxr/nClean.git
cd nClean
  1. Build the Docker image
bash
docker buildx build -t nclean .
  1. Run the Docker container
bash
docker run -d -p 5002:5002 nclean --name nclean