Wirely Hosting & License Activation

1. Wirely (Offline) Installation Guide

The offline version of Wirely is powered by Docker, and the necessary files are provided to host a localized version. If you are unable to run Docker, you can use the requirements.txt file along with Python 3 (version 3.8.10 or higher) to run it locally with Flask.

1.1. File Contents

Purchasing a license for Wirely also includes the hosting files, typically structured as follows:

dist
|-- app/
|   |-- static/
|   |-- templates/
|-- app.py
|-- Copyright Notice.doc
|-- Copyright Notice.pdf
|-- Disclaimer.docx
|-- Disclaimer.html
|-- Disclaimer.md
|-- Dockerfile
|-- docs.pdf
|-- eula.html
|-- EULA.txt
|-- README.txt
|-- requirements.txt
|-- hosting.pdf

2. Running Via Docker

Note: On Linux, these commands may require superuser privileges.

2.1. Building Wirely Docker Image

To build the Wirely Docker image, navigate to the directory containing the Dockerfile and run:

docker build --tag wirely .

2.2. Checking Docker Images

To list all Docker images on your system, use:

docker images

2.3. Running Wirely Docker Image

To run Wirely as a Docker container on localhost, port 5000:

docker run -d -p 5000:5000 wirely

2.4. Accessing the Application (Via a Web-browser)

Once the Docker container is running, you can access Wirely in your web browser at:

localhost:5000/wirely

2.5. Checking Running Containers

To view all running Docker containers, use:

docker ps

2.6. Stopping Containers

To stop a running Docker container, use its container ID (found via docker ps):

docker stop <container-id>

3. Running via Python3

3.1. Virtual Environments

For more general information on Python Virtual Environments, refer to the official Python documentation.

Using a virtual environment is highly recommended for Wirely. This ensures that all dependencies required to run Wirely are isolated and do not interfere with other Python installations on your system.

3.1.1. Creating Virtual Environments

Ensure you are inside the dist directory. You might need to install the virtualenv package depending on your Python version.

python -m venv venv

3.1.2. Activating Virtual Environments

From your command line, run the appropriate command for your operating system:

Windows:

venv\Scripts\activate.bat

Unix or macOS:

source venv/bin/activate

3.1.3. Installing Required Python3 Dependencies

After activating your virtual environment, install the necessary dependencies using pip:

python -m pip install -r requirements.txt

Note: This process may take some time as it gathers all required modules for the application to run.

Once complete, you may start the Wirely host and access it via a web browser.

3.2. Running Wirely (Flask)

Make sure you are inside the dist directory with your virtual environment activated.

Running Wirely on localhost (127.0.0.1) and port 5000:

flask run --host="127.0.0.1" --port=5000

3.3. Accessing the Application (Via a Web-browser)

Access the running Wirely application in your web browser at:

localhost:5000/wirely

4. Running Pre-built Binaries

To run a pre-build binary: Navigate to the wirely downloads website: here.
Windows: Wirely-Setup-x.x.xx.exe
Linux: Wirely-x.x.xx.AppImage
Mac: Wirely-x.x.xx.dmg

For windows, simply install the Wirely Application. After installation, the application should start. For Linux, you may either use the command line or through the file explorer. Make sure to enable "Allow executing file as program" under permissions in the properties window. You may also use chmod from the command line. Double click (in file explorer) or start in command line. Note: For the pre-built binaries, the default port is 8080.

5. License

5.1. Activating the License

Once the application is opened, there will be a red "Activate" button located at the top right of the menu bar.

Note: License validation requires Internet Access.

Once the "Activate" button is clicked, kindly point it to the license file that will be supplied to you.

It should take a moment, but it should be activated shortly. If it does not, kindly reach out to phasorsys@gmail.com.

If there is a license activation model that works better for you, please do not hesitate to reach out to phasorsys@gmail.com.