manual:installation:windows

Installing RePoSyD on Windows

  1. Install Node.js and YARN.
  2. Install the RePoSyD Command Line Interface (CLI) from the RePoSyD registry.
  3. Use the RePoSyD CLI to install the RePoSyD services on your computer.
  4. Run RePoSyD as a Service or from the Command Line.

Open your favorite web browser, navigate to https://nodejs.org/download/release/v16.20.1 and download the Installer for the 64-bit version of Node.js (https://nodejs.org/download/release/v16.20.1/node-v16.20.1-x64.msi). Alternative you can use the ZIP-version (node-v16.20.1-win-x64.zip) for the installation.

Once the download is completed, open the installer to start the installation. Fig. 1: Node.js Installer

Click on Next until you reach the step “Tools for Native Modules”. Click on the checkbox to enable the installation of additional build tools. Step "Tools for Native ModulesFig. 2

Automatically install necessary tools

The installation of RePoSyD will fail, if this option is not activated!

After completion of the installer, open a command prompt (or PowerShell) and enter the following:

C:\> node -v

The system should display the Node.js version installed on your system.

C:\> node -v
v16.20.1

Open a command prompt (or PowerShell), and enter the following:

C:\> npm install -g yarn

Installing YARN behind a Proxy Server

If RePoSyD is installed in a corporate environment, you may need to configure NPM to provide authentication for the proxy server. Open a command shell and enter the following commands to configure NPM to use an HTTP and/or HTTPS proxy.

$ npm config set proxy http://username:password@host:port
$ npm config set https-proxy http://username:password@host:port

Or add the settings directly to your ~/.npmrc file:

proxy=http://username:password@host:port
https-proxy=http://username:password@host:port

After completion of the installer, enter the following:

C:\> yarn -v

The system should display the YARN version installed on your system.

C:\> yarn -v
v1.22.19

Open a command prompt (or PowerShell), and enter the following:

C:\> yarn config set registry https://pkg.reposyd.de/registry 
yarn config v1.22.19
success Set "registry" to "https://pkg.reposyd.de/registry".
Done in 0.04s.

C:\> yarn global add @reposyd/cli
yarn global v1.22.19
[1/4] Resolving packages...
...
[4/4] Building fresh packages...
success Installed "@reposyd/cli@1.5.1" with binaries:
      - reposyd
Done in 42.99s.

The installation of @reposyd\cli as a global package may fail, if you are using nvm to manage your Node.js versions. In this case use npm for the installation.

$ npm config set registry https://pkg.reposyd.de/registry 

$ npm i -g @reposyd/cli

Installing @reposyd/cli behind a Proxy Server

If RePoSyD is installed in a corporate environment, you may need to configure YARN to provide authentication for the proxy server. Open a command shell and enter the following commands to configure NPM to use an HTTP and/or HTTPS proxy.

$ yarn config set proxy http://username:password@host:port
$ yarn config set https-proxy http://username:password@host:port

Or add the settings directly to your ~/.yarnrc file:

proxy=http://username:password@host:port
https-proxy=http://username:password@host:port
C:\> reposyd -V
2.0.0

C:\>

Open a command prompt and run the following command:

C:\> reposyd install c:\temp\reposyd
info: root folder 'c:/temp/reposyd' created.
info: intalling RePoSyD packages...
info: RePoSyD packages installation completed
info: creating RePoSyD configuration file...
info: initializing repository...
info: initialization completed
url      sqlite:c:/temp/reposyd/database?database=reposyd.sqlite
schema   0.34.0
account  admin
password gukidaka
uuid     {e6700c3e-f17f-455f-a6a0-92d45dadd3ab}

Automatically Generated Password

Do not forget to write down the automatically generated password.

If you don't want to use an autogenerated password, you specify your own password using the CLI option –password.

C:\> reposyd install c:\temp\reposyd --password <mypassword>

For more information, see RePoSyD CLI.

The following folder structure is created for running the RePoSyD Services:

Folder Content
<root> Root folder of the installation.
app Contains the files of the RePoSyD Web Application
config Configuration files, e.g. RePoSyD API config.
data
backup Location of backup files.
database Location of the database files.
log Log files
templates Templates for email generation.
service Contains the files for running the RePoSyD REST API and Win/Mac service

The RePoSyD web application is normally installed during the installation of the RePoSyD REST API. To install the application manually, open a command prompt and run the following command:

C:\> reposyd app install c:\inetpub\wwwroot
info: RePoSyD App installation completed

C:\>

RePoSyD requires the installation of the following IIS server functions:

The following URL rewrite rules need to be set up for RePoSyD:

URL Pattern Target
http(s)://<servername>/api ^api/(.*) http://127.0.0.1:3000/{R:1} The request is redirected to RePoSyD and /api is removed from the URL. A query string remains unchanged (option append query string enabled)
http(s)://servername>/auth ^auth/(.*) http://127.0.0.1:3000/auth/{R:1} The request is redirect to RePoSyD and remains unchanged (option append query string enabled).
location /api/ {
	proxy_pass http://127.0.0.1:32769;
	rewrite ^/api/?(.*) /$1 break;
}
location /auth {
	proxy_pass http://127.0.0.1:32769;
	proxy_set_header Host            $host:$server_port;
	proxy_set_header X-Forwarded-For $remote_addr;
	proxy_set_header X-Forwarded-Proto $scheme;
}
This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
  • manual/installation/windows.txt
  • Last modified: 13 months ago
  • by maho