Skip to content

1. Installation

Evgeny Abramovich edited this page Dec 26, 2024 · 5 revisions

UNCORS offers many installation methods. Check out the available methods below.

Package managers

Homebrew (macOS | Linux)

If you are on macOS or Linux and using Homebrew, you can install UNCORS with the following one-liner:

brew install evg4b/tap/uncors

Scoop (Windows)

If you are on Windows and using Scoop, you can install UNCORS with the following commands:

scoop bucket add evg4b https://github.com/evg4b/scoop-bucket.git
scoop install evg4b/uncors

NPM (Cross-platform)

To install UNCORS as a Node package in your project, you can use the following commands:

Via npm:

npm install uncors --save-dev

Via yarn:

yarn add uncors --dev

Docker (Cross-platform)

We currently offer images for Docker.

docker run -p 80:3000 evg4b/uncors --from 'http://local.github.com' --to 'https://github.com'

Install the binary

Stew (Cross-platform)

Also, you can install binaries using Stew with the following commands:

stew install evg4b/uncors

Binary (Cross-platform)

Download the appropriate version for your platform from the UNCORS releases page. Once downloaded, the binary can be run from anywhere. You don’t need to install it into a global location. This works well for shared hosts and other systems where you don’t have a privileged account.

Ideally, you should install it somewhere in your PATH for easy use. /usr/local/bin is the most probable location.

Build from source

Prerequisite Tools

  • Git
  • Go (at least Go 1.21)

Fetch from GitHub

UNCORS uses the Go Modules support built into Go 1.11 to build. The easiest way to get started is to clone the UNCORS source code in a directory outside the GOPATH, as in the following example:

mkdir $HOME/src
cd $HOME/src
git clone https://github.com/evg4b/uncors.git
cd uncors
go install -tags release

If you are a Windows user, substitute the $HOME environment variable above with %USERPROFILE%.