Skip to content

The simplest way to install Netsocs on Windows is through Docker.

Requirements

Installation Steps

  1. Ensure that Docker Engine is running. To do this, in the lower left corner of the screen, you will see a text indicating that Docker is running.

  2. Download the zip or tar.gz file of the version you want to install directly from our releases page. There you will find all available versions for download. Once you locate the version you want to install, download it.

  3. Once the file is downloaded, extract the folder containing the compressed file and open the file called .env. This file contains the different configurations you can make for your installation. The minimum configuration is the IP address or domain name of your server. You can open the file with any text editor like Windows Notepad.

    Help articles: - How to get your server's IP address

  4. In the first line of the .env file, you can configure your server's domain name in the HTTP_HOSTNAME variable. The default value is https://192.168.1.100. Make sure to keep the https:// at the beginning.

    Do not use localhost or 127.0.0.1

    It is important that you do not use localhost or 127.0.0.1 as the value for the HTTP_HOSTNAME variable as Netsocs will not work correctly.

  5. In the root folder of the extracted files, locate the install.bat file.

  6. Double-click on install.bat to start the installation process. A console window will open showing the progress.

  7. When the installation completes successfully, you will see a success message with the following information:

    - Access point: The main Netsocs URL is shown under "Access URLs" (e.g., Main: https://172.20.80.1). Press Ctrl + Click on the URL to open it in your browser. - Credentials: The Netsocs Admin credentials are displayed at the bottom — username admin and a randomly generated password for your installation.

  8. Before finishing, you must accept the self-generated certificate. When you first access the Netsocs URL in your browser, a security warning will appear because the certificate is self-signed. Accept the certificate to proceed and complete the setup.

    Hostname change requires certificate reinstall

    If you change the HTTP_HOSTNAME variable after installation, you must reinstall the certificate on this machine and on any other clients that had it installed.

    At the end, instructions will be displayed on how to install the certificate on other clients (other PCs) so they can access Netsocs without security warnings.

  • Add your first device

Add your first device to Netsocs.

Continue

  • Configure a remote site

Configure a remote site to access Netsocs from anywhere.

Continue

Common Issues

Error response from daemon: ports are not available

If when starting the containers, the following error appears:

Error response from daemon: ports are not available

This means that port 80 or 443 is already in use by another program. You must ensure that no other program is using these ports.