Holochain Launcher v0.9.1

To download the Holochain Launcher scroll down to "Assets".

Changes

• This version introduces automatic updates, meaning that from now on and as long as there are no breaking changes in the Holochain version that the Launcher is using or in lair-keystore, the Holochain Launcher can be updated directly from within the Launcher itself. Automatic updates are supported for Windows, macOS and AppImage on Linux. For automatic updates to succeed with a .app file on macOS (instead of installed via .dmg bundle) the .app file needs to be located in the Applications folder due to file permissions.
• Windows .msi files are code-signed and the SmartScreen warning upon installation is therefore finally removed
• The Launcher now rejects zome calls with a provenance other than the public key of the app that the calling UI has been installed for
• Fixed an issue that could occur during updating of a hApp's UI
• Added a 404 page in case the index.html of a hApp's UI cannot be found

Installation

Windows

1. Download the Holochain Launcher .msi file and double click on it.
2. Run through the setup.

macOS (currently supported versions: v10.15 and later)

1. Download the .dmg file, open it, and drag the application to your Applications folder.
2. Go to your applications folder and open it.

Linux

AppImage

1. Download the .AppImage file.
2. Double-click on it to run it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Known issues and Limitations

...for end-users:

• Downloading of files from a Holochain App to the file system is not yet supported on macOS but will likely be added soon (tauri-apps/tauri#4633)
• Launcher can freeze on macOS if an app is opened while in full-screen mode
• App windows don't have their own menu on macOS (tauri-apps/tauri#5768)
• Clicking on "Open App" of an app that is already open will not unminimize it on some Linux distributions in case it is minimized (tauri-apps/tauri#5974)

...for hApp developers:

• Tauri uses the webview of the platform the Launcher is running on, meaning that hApps need to be bundled for those older target browsers in order to be compatible on older operating systems.
• WebRTC is not yet supported for Linux (tauri-apps/wry#85)

Feedback is really appreciated! Click on Report Issue in the top right corner of the Holochain Launcher to file a bug in this repository.

Note

• This is not yet a security ready release. Holochain's immune system will be fully implemented with Holochain 0.2.

Holochain Launcher v0.9.0 - For Holochain Beta 0.1

To download the Holochain Launcher scroll down to "Assets".

Installation

Windows

1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

macOS (currently supported versions: v10.15 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and open it.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Known issues and Limitations

...for end-users:

• Downloading of files from a Holochain App to the file system is not yet supported on macOS but will likely be added soon (tauri-apps/tauri#4633)
• Launcher can freeze on macOS if an app is opened while in full-screen mode
• App windows don't have their own menu on macOS (tauri-apps/tauri#5768)
• Clicking on "Open App" of an app that is already open will not unminimize it on some Linux distributions in case it is minimized (tauri-apps/tauri#5974)

...for hApp developers:

• Tauri uses the webview of the platform the Launcher is running on, meaning that hApps need to be bundled for those older target browsers in order to be compatible on older operating systems.
• WebRTC is not yet supported for Linux (tauri-apps/wry#85)

Feedback is really appreciated! Click on Report Issue in the top right corner of the Holochain Launcher to file a bug in this repository.

Note

• This is not yet a security ready release. Holochain's immune system will be fully implemented with Holochain 0.2.
• Security warnings on Windows will be removed soon.

Holochain Launcher v0.8.0

See assets below to download and install this version.

Supported Holochain Versions

• Holochain v0.1.0-beta-rc.3 (HDK v0.1.0-beta-rc.2)

Changes

• Support for Holochain v0.1.0-beta-rc.3
• New DevHub at Holochain v0.1.0-beta-rc.3
• Implemented zome call signing through lair
• Added progress bars to indicate active gossip with peers (historical gossip)
• UX improvements around setup process
• Improved error messages during app installation
• Option to update app UI's to the latest version
• data is stored in a new folder structure on the file system

Bug Fixes

• Fixed issues with loading assets from remote URL's
• Switched to redirect to index.html of the hApp in case a URL to an asset is not found. Should solve issues with push state routing.
• Fixed issue where hApps shared the same localStorage
• Fixed issue around drag and drop not working properly (f08db1f)
• Holochain version is auto-selected again for happs installed via the App Library

Known issues

...for end-users:

• Progress bars never reach 100%. This is a bug that will be fixed in a future release.
• Launcher can freeze on macOS if an app is opened while in full-screen mode
• App windows don't have their own menu on macOS (tauri-apps/tauri#5768)
• Clicking on "open App" of an app that is already open will not unminimize it on some Linux distributions in case it is minimized (tauri-apps/tauri#5974)

...for hApp developers:

• Tauri uses the webview of the platform the Launcher is running on, meaning that hApps need to be bundled for those older target browsers in order to be compatible on older operating systems.
• WebRTC is not yet supported for Linux (tauri-apps/wry#85)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Click on Report Issue in the top right corner of the Holochain Launcher to file a bug in this repository.

Installation

Windows

1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and open it.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.7.1

See the "Assets" at the bottom to download and install this version of the Holochain Launcher.

Changes

• Adds support for Holochain version 0.0.169 (HDK v0.0.157)
• Fixes some smaller UI issues

Supported Holochain Versions

• Holochain v0.0.162 (HDK v0.0.152)
• Holochain v0.0.165 (HDK v0.0.154)
• Holochain v0.0.169 (HDK v0.0.157)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Click on Report Issue in the top right corner of the Holochain Launcher to file a bug in this repository.

Installation

Windows

1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.7.0

See the "Assets" at the bottom to download and install this version of the Holochain Launcher.

Changes

This version of the Holochain Launcher comes with an new look and an important change in that hApps are now opened in tauri windows instead of the browser.

Opening apps in tauri windows is an important step towards providing a secure environment for running holochain applications. It also means that the webview is now platform dependent (WebView2 on Windows and WebKit on macOS and Linux) and may somteimes behave differently than in common browsers.

Supported Holochain Versions

• Holochain v0.0.162 (HDK v0.0.152)
• Holochain v0.0.165 (HDK v0.0.154)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Click on Report Issue in the top right corner of the Holochain Launcher to file a bug in this repository.

Installation

Windows

1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.6.0

See the "Assets" at the bottom to download and install this version.

Supported Holochain Versions

• Holochain v0.0.162 (HDK v0.0.152)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Go to Help > Report Issue to file a bug in this repository.

Changes

• Support for Holochain version 0.0.162 (and the corresponding DevHub) which improves gossiping of large entries
• Add database encryption at rest
• added compatibility with Ubuntu 22.04
• minor UX and other improvements

Installation

Windows

0. Download and install the Microsoft WebView package.
1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.5.1

See the "Assets" at the bottom to download and install this version.

IMPORTANT NOTE: In one of the upcoming releases, the conductor's databases will start to be encrypted at rest, anticipating the same upcoming change of the official Holochain repository. This means that it will be impossible to access any data stored with earlier versions of the Holochain Launcher, including this one.

Supported Holochain Versions

• Holochain v0.0.145 (HDK v0.0.138)
• Holochain v0.0.150 (HDK v0.0.142)
• Holochain v0.0.152 (HDK v0.0.144)
• Holochain v0.0.154 (HDK v0.0.146)
• Holochain v0.0.156 (HDK v0.0.147)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Go to Help > Report Issue to file a bug in this repository.

Changes

• Fixed backwards Network Seed compatibility.

If you installed previous versions of the Holochain Launcher it is possible that you need to perform a factory reset in order to be able to install and run apps.

Installation

Windows

0. Download and install the Microsoft WebView package.
1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

👉 Ubuntu 22.04: For Ubuntu 22.04 use the corresponding [...]_UBUNTU_22_04_ONLY.deb/[...]_UBUNTU_22_04_ONLY.AppImage files.

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.5.0

See the "Assets" at the bottom to download and install this version.

IMPORTANT NOTE: In one of the upcoming releases, the conductor's databases will start to be encrypted at rest, anticipating the same upcoming change of the official Holochain repository. This means that it will be impossible to access any data stored with earlier versions of the Holochain Launcher, including this one.

Supported Holochain Versions

• Holochain v0.0.145 (HDK v0.0.138)
• Holochain v0.0.150 (HDK v0.0.142)
• Holochain v0.0.152 (HDK v0.0.144)
• Holochain v0.0.154 (HDK v0.0.146)
• Holochain v0.0.156 (HDK v0.0.147)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Go to Help > Report Issue to file a bug in this repository.

Changes

• Added support for Holochain version 0.0.156 (HDK v0.0.147), removed support for Holochain version 0.0.143 (HDK v0.0.136).
• Replaced the DevHub version by the new DevHub version (Holochain v0.0.156/HDK v0.0.147) which supports publishing hApps of all post-integrity/coordinator-split Holochain/HDK versions.

If you installed previous versions of the Holochain Launcher it is possible that you need to perform a factory reset in order to be able to install and run apps.

Installation

Windows

0. Download and install the Microsoft WebView package.
1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

👉 Ubuntu 22.04: For Ubuntu 22.04 use the corresponding [...]_UBUNTU_22_04_ONLY.deb/[...]_UBUNTU_22_04_ONLY.AppImage files.

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.4.11

See the "Assets" at the bottom to download and install this version.

IMPORTANT NOTE: In one of the upcoming releases, the conductor's databases will start to be encrypted at rest, anticipating the same upcoming change of the official Holochain repository. This means that it will be impossible to access any data stored with earlier versions of the Holochain Launcher, including this one.

Supported Holochain Versions

• Holochain v0.0.143 (HDK v0.0.136)
• Holochain v0.0.145 (HDK v0.0.138)
• Holochain v0.0.150 (HDK v0.0.142)
• Holochain v0.0.152 (HDK v0.0.144)
• Holochain v0.0.154 (HDK v0.0.146)

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Go to Help > Report Issue to file a bug in this repository.

Changes

• Added support for Holochain versions v0.0.150, v0.0.152 and v0.0.154.
• Added a workaround for an error that could occur when launching a Holochain version within the launcher (#55).

If you installed previous versions of the Holochain Launcher it is possible that you need to perform a factory reset in order to be able to install and run apps.

Installation

Windows

0. Download and install the Microsoft WebView package.
1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.

Holochain Launcher v0.4.10

See the assets to download this version and install.

Supported Holochain Versions

• Holochain v0.0.143
  • HDK v0.0.136
• Holochain v0.0.150
  • HDK v0.0.142

Pre-Release

This is not yet a production ready release. Expect bugs, and features not working perfectly.

Feedback is really appreciated! Go to Help > Report Issue to file a bug in this repository.

Changes

• Upgraded to Holochain v0.0.150.
• Upgraded to lair v0.2.0.

If you installed previous versions of the Holochain Launcher, please perform a factory reset or you won't be able to install apps.

Installation

Windows

0. Download and install the Microsoft WebView package.
1. Download the Holochain Launcher .msi file and double click on it.
2. If the Microsoft Defender SmartScreen pops up, click on "More information" and click "Execute anyway".
3. Run through the setup.

If during the installation an error shows saying "A program run as part of the setup did not finish as expected", install the Microsoft WebView and try installing the Holochain Launcher again.

MacOs (supported versions: v10.13 and later)

1. Download the .dmg, open it, and drag the application to your Applications folder.
2. Go to your applications folder, and (important!) right click on it, and click open.
3. Click 'Open' when it gives you a warning about 'Unidentified Developer'.

Linux

AppImage

1. Download the .AppImage.
2. Install it (you may have to give executable permissions to the AppImage file).

Deb

1. Upgrade your dependencies with sudo apt-get update && sudo apt-get upgrade.
2. Download the .deb file.
3. Install it (you may have to upgrade your dependencies).

Aur

If you're on ArchLinux, you can go to https://aur.archlinux.org/packages/holochain-launcher/ and install the package with pacman or yay.

Note

• This is not yet a production ready release, mainly due to security reasons. This will become possible once the Holochain immune system gets fully implemented, the encryption at rest is enabled, and there is a security audit confirming that the system is secure.
• Security warnings on Windows and MacOs will be removed in future versions.