MacOS X installation

WebOne have experimental support for Apple macOS. If you have problems with running WebOne on macOS, first try to follow steps for manual Linux installation, then if they won't help, try older versions of WebOne. The project bug tracker is a good place to report about problems or errors.

See also: Linux installation | Windows installation.

1. Make sure that you are use an actual version of macOS. Supported versions. If you have an older macOS, rebuild WebOne from sources for it.
2. Download and install the .NET 10.0 Runtime from Microsoft.
   • Hint.
   • Or install it via Homebrew.

     brew tap junian/homebrew-dotnet
     brew install dotnet-sdk@10.0

   • Ensure the correct .NET version is installed by entering dotnet --list-runtimes in Terminal.
3. Download and unzip the WebOne for Mac.
   • Make sure that .NET Runtime have same architecture as WebOne (Intel Core x64 vs Apple M1 Arm64)
4. To allow picture file converting, install ImageMagick for Mac.
5. To allow online video converting, install FFmpeg and YT-dlp.
6. Open a new Terminal window, and go to the downloads folder: cd ~/Downloads/WebOne.0.19.0.mac-intel/ or cd ~/Downloads/WebOne.0.19.0.mac-m/
7. Mark the program file as executable, remove Apple's security barriers (the application have no digital signature, so macOS 10.15+ systems probably may require applying a developer signature):

   chmod +x webone
   xattr -d com.apple.quarantine webone
   codesign --force --deep -s - ./webone
   

8. Execute:
   • ./webone
   • Note: If the first time you execute WebOne from Finder window, you're likely to get a security prompt from macOS, saying "WebOne cannot be opened because the developer cannot be verified." Open your Security & Privacy settings in the System Preferences and click "Allow Anyway".
9. Your WebOne environment is now running and ready for incoming connections.
10. To exit: Control + C or close Terminal tab.

To view the server log, you may look in Applications/Utilities for the Console application, then select ~/Library/Logs folder and webone.log file. The display is live, so it is not need to reload log to view new messages.

If you are experiencing problems with HTTPS connections from retro clients, run export OPENSSL_CONF=/Users/your-user-name-here/Downloads/WebOne.0.19.0.mac-intel/openssl_webone.cnf in Terminal before webone command.

1. Stop WebOne by pressing Control + C.
2. Create personal configuration file: touch my.conf (the name may be any).
   • Later you can use this file to store your WebOne settings and rules.
3. Open the created file in TextEdit or other editor.
4. Configuration guide.
   • Example and default configuration is in the downloaded webone.conf.
5. Restart WebOne.

There is a known way to start WebOne on system launch time: 🔗

You may change TargetFramework in the WebOne.csproj file to net6.0, and compile WebOne for macOS 10.14 using build.sh and .NET 6.0 SDK. Note that such builds are not officially supported, but are working. The .NET documentation says that the sixth SDK requires macOS 10.15, really it is working on macOS 10.14 too (WebOne 0.17.6 confirms this - it is last .NET6-based official release).