From d6886838d3c89f9d2127bf95eadfc7c18e9f77a0 Mon Sep 17 00:00:00 2001 From: Andrew Baumbach Date: Fri, 24 Apr 2026 11:36:46 -0400 Subject: [PATCH 1/5] chore: update Twingate docker compose --- Apps/Twingate/docker-compose.yml | 49 +++++++++++++++++--------------- 1 file changed, 26 insertions(+), 23 deletions(-) diff --git a/Apps/Twingate/docker-compose.yml b/Apps/Twingate/docker-compose.yml index 854df0299..7ad04c561 100644 --- a/Apps/Twingate/docker-compose.yml +++ b/Apps/Twingate/docker-compose.yml @@ -9,11 +9,10 @@ services: TWINGATE_NETWORK: "" TWINGATE_ACCESS_TOKEN: "" TWINGATE_REFRESH_TOKEN: "" - TWINGATE_LABEL_HOSTNAME: ${HOSTNAME} + TWINGATE_LABEL_DEPLOYED_BY: "zimaos" + TWINGATE_LABEL_HOSTNAME: "" restart: unless-stopped - sysctls: - net.ipv4.ping_group_range: "0 2147483647" network_mode: default privileged: false cpu_shares: 90 @@ -21,25 +20,16 @@ services: envs: - container: TWINGATE_NETWORK description: - en_us: "" + en_us: "Name of the Twingate Network to connect to. Example: 'https://{network_name}.twingate.com'" - container: TWINGATE_ACCESS_TOKEN description: - en_us: "" + en_us: "The Twingate Access Token. You can generate one from the Twingate Admin Console." - container: TWINGATE_REFRESH_TOKEN description: - en_us: "" + en_us: "The Twingate Refresh Token. You can generate one from the Twingate Admin Console." - container: TWINGATE_LABEL_HOSTNAME description: - en_us: "" - - container: PATH - description: - en_us: "" - - container: SSL_CERT_FILE - description: - en_us: "" - - container: TWINGATE_API_ENDPOINT - description: - en_us: "" + en_us: "The hostname label for the Twingate Connector." deploy: resources: reservations: @@ -54,16 +44,29 @@ x-casaos: author: Shubhankar Trivedi category: Network description: - en_us: It's a connector for Twingate". + en_us: "Install the Twingate Connector on ZimaOS to securely connect your home network to the Twingate network. This allows you to access your home network resources from anywhere without exposing them to the internet." developer: Twingate icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Twingate/icon.png screenshot_link: tagline: - en_us: Twingate Connector for CasaOS + en_us: Twingate Connector for ZimaOS thumbnail: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Twingate/thumbnail.png - tips: {} + tips: + "before_install": + en_us: | + **Twingate Account Information** + To use the Twingate Connector, you will need to have a Twingate account and a Twingate Network set up. You can sign up for a free Twingate account at [https://www.twingate.com](https://www.twingate.com). Once you have an account, you can create a Twingate Network and generate the necessary Access Token and Refresh Token from the Twingate Admin Console. + + **Post Installation Configuration** + After installing the Twingate Connector, you will need to configure the environment variables with your Twingate account information. This includes the TWINGATE_NETWORK, TWINGATE_ACCESS_TOKEN, and TWINGATE_REFRESH_TOKEN. You can do this from the ZimaOS application settings. Click the ellipsis (...) in the top right corner of the Twingate Connector app and select 'Settings'. Make sure to save the changes after updating the environment variables. For easy access to your Admin Console, add your URL to the "Web UI" field. EXAMPLE: Select `https` in drop down the add {network_name}.twingate.com/networks/overview to the "Web UI" field. + + **Supported OS Disclaimer** + This app store entry is only supported on ZimaOS. CasaOS requires a custom installation. For more information visit [The official Twingate CasaOS documentation page](https://www.twingate.com/docs). + + **Official Documentation** + For a setup guide using this app, please refer to the official Twingate documentation for ZimaOS: [https://www.twingate.com/docs](https://www.twingate.com/docs). + + **Community Support** + If you have any questions or need help with the Twingate Connector, you can reach out on the [Twingate subreddit](https://www.reddit.com/r/twingate/). title: - en_us: Twingate - hostname: "" - index: / - port_map: "" + en_us: Twingate Connector From f1651f0a4b357296dfb8ff9b16b9bc1456e1b4bb Mon Sep 17 00:00:00 2001 From: Andrew Baumbach Date: Fri, 24 Apr 2026 11:37:04 -0400 Subject: [PATCH 2/5] chore: carry over changes to appfile --- Apps/Twingate/appfile.json | 46 ++++++++++++++++++++++++++++++++------ 1 file changed, 39 insertions(+), 7 deletions(-) diff --git a/Apps/Twingate/appfile.json b/Apps/Twingate/appfile.json index ff57bcc1e..7d46e6770 100644 --- a/Apps/Twingate/appfile.json +++ b/Apps/Twingate/appfile.json @@ -1,10 +1,10 @@ { - "version": "1.0", + "version": "2.0", "title": "Twingate", "name": "twingate-connector", "icon": "https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Twingate/icon.png", - "tagline": "Twingate Connector for CasaOS", - "overview": "It's a connector for Twingate", + "tagline": "Twingate Connector for ZimaOS", + "overview": "The Twingate Connector is a lightweight application that allows you to securely connect your ZimaOS device to your Twingate network. It provides seamless access to your private resources without the need for a traditional VPN, ensuring a secure and efficient connection. With the Twingate Connector, you can easily manage and access your network resources from anywhere, while maintaining the security and performance of your ZimaOS device.", "thumbnail": "https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Twingate/thumbnail.png", "screenshots": [ ], @@ -35,19 +35,30 @@ "envs": [ { "name": "TWINGATE_NETWORK", - "value": "rasp" + "description": "The name of your Twingate network. This can be found in the Twingate Admin Console under Network Settings.", + "value": "" }, { "name": "TWINGATE_ACCESS_TOKEN", + "description": "The Twingate Access Token. You can generate one from the Twingate Admin Console.", "value": "" }, { "name": "TWINGATE_REFRESH_TOKEN", + "description": "The Twingate Refresh Token. You can generate one from the Twingate Admin Console.", "value": "" }, { "name": "TWINGATE_LABEL_HOSTNAME", - "value": "`hostname`" + "description": "The hostname label for the Twingate connector.", + "configurable": "advanced", + "value": "" + }, + { + "name": "TWINGATE_LABEL_DEPLOYED_BY", + "description": "The deployed by label for the Twingate connector.", + "configurable": "no", + "value": "zimaos" } ], "ports": [], @@ -75,11 +86,32 @@ "upnp": false }, "tips": { - "before_install": [] + "before_install": [ + { + "content": "Twingate Account Information", + "value": "To use the Twingate Connector, you will need to have a Twingate account and a Twingate network set up. You can sign up for a free Twingate account at [https://www.twingate.com](https://www.twingate.com). Once you have an account, you can create a Twingate network and generate the necessary Access Token and Refresh Token from the Twingate Admin Console." + }, + { + "content": "Post Installation Configuration", + "value": "After installing the Twingate Connector, you will need to configure the environment variables with your Twingate account information. This includes the TWINGATE_NETWORK, TWINGATE_ACCESS_TOKEN, and TWINGATE_REFRESH_TOKEN. You can do this from the CasaOS application settings. Click the ellipsis (...) in the top right corner of the Twingate Connector app and select 'Settings'. Make sure to save the changes after updating the environment variables. For easy access to the admin console, add your admin URL to the \"Web UI\" field." + }, + { + "content": "Supported OS Disclaimer", + "value": "This app store entry is only supported on ZimaOS. CasaOS requires a custom installation. For more information visit [The official Twingate CasaOS documentation page](https://www.twingate.com/docs)." + }, + { + "content": "Official Documentation", + "value": "For a setup guide using this app, please refer to the official Twingate documentation for ZimaOS: [https://www.twingate.com/docs](https://www.twingate.com/docs)." + }, + { + "content": "Community Support", + "value": "If you have any questions or need help with the Twingate Connector, you can reach out on the [Twingate subreddit](https://www.reddit.com/r/twingate/)." + } + ] }, "changelog": { "latest_updates": "", "url": "" }, - "latest_update_date": "1667464530" + "latest_update_date": "1777044342" } \ No newline at end of file From dfdc7bf9348620bbacabf14c6897b4f9bf231eb3 Mon Sep 17 00:00:00 2001 From: Andrew Baumbach Date: Fri, 24 Apr 2026 12:54:15 -0400 Subject: [PATCH 3/5] chore: add sysctls block back --- Apps/Twingate/docker-compose.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Apps/Twingate/docker-compose.yml b/Apps/Twingate/docker-compose.yml index 7ad04c561..5673d1448 100644 --- a/Apps/Twingate/docker-compose.yml +++ b/Apps/Twingate/docker-compose.yml @@ -13,6 +13,8 @@ services: TWINGATE_LABEL_HOSTNAME: "" restart: unless-stopped + sysctls: + net.ipv4.ping_group_range: "0 2147483647" network_mode: default privileged: false cpu_shares: 90 From 4676b00adcdafe125437c774dde8e49fbaeb0794 Mon Sep 17 00:00:00 2001 From: Andrew Baumbach Date: Fri, 24 Apr 2026 16:34:13 -0400 Subject: [PATCH 4/5] chore: update links --- Apps/Twingate/docker-compose.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Apps/Twingate/docker-compose.yml b/Apps/Twingate/docker-compose.yml index 5673d1448..767f9cc0e 100644 --- a/Apps/Twingate/docker-compose.yml +++ b/Apps/Twingate/docker-compose.yml @@ -57,16 +57,16 @@ x-casaos: "before_install": en_us: | **Twingate Account Information** - To use the Twingate Connector, you will need to have a Twingate account and a Twingate Network set up. You can sign up for a free Twingate account at [https://www.twingate.com](https://www.twingate.com). Once you have an account, you can create a Twingate Network and generate the necessary Access Token and Refresh Token from the Twingate Admin Console. + To use the Twingate Connector, you will need to have a Twingate account and a Twingate Network set up. You can sign up for a free Twingate account [here](https://auth.twingate.com/signup-v2). Once you have an account, you can create a Twingate Network and generate the necessary Access Token and Refresh Token from the Twingate Admin Console. **Post Installation Configuration** - After installing the Twingate Connector, you will need to configure the environment variables with your Twingate account information. This includes the TWINGATE_NETWORK, TWINGATE_ACCESS_TOKEN, and TWINGATE_REFRESH_TOKEN. You can do this from the ZimaOS application settings. Click the ellipsis (...) in the top right corner of the Twingate Connector app and select 'Settings'. Make sure to save the changes after updating the environment variables. For easy access to your Admin Console, add your URL to the "Web UI" field. EXAMPLE: Select `https` in drop down the add {network_name}.twingate.com/networks/overview to the "Web UI" field. + After installing the Twingate Connector, you will need to configure the environment variables with your Twingate account information. This includes the TWINGATE_NETWORK, TWINGATE_ACCESS_TOKEN, and TWINGATE_REFRESH_TOKEN. You can do this from the ZimaOS application settings. Click the ellipsis (...) in the top right corner of the Twingate Connector app on the main dashboard and select 'Settings'. Make sure to save the changes after updating the environment variables. For easy access to your Admin Console, add your URL to the "Web UI" field. EXAMPLE: Select `https` in drop down the add {network_name}.twingate.com/networks/overview to the "Web UI" field. **Supported OS Disclaimer** - This app store entry is only supported on ZimaOS. CasaOS requires a custom installation. For more information visit [The official Twingate CasaOS documentation page](https://www.twingate.com/docs). + This app store entry is only supported on ZimaOS. CasaOS requires a custom installation. For more information visit [The official Twingate CasaOS documentation page](https://www.twingate.com/docs/casaos-getting-started). **Official Documentation** - For a setup guide using this app, please refer to the official Twingate documentation for ZimaOS: [https://www.twingate.com/docs](https://www.twingate.com/docs). + For a setup guide using this app, please refer to the [Official Twingate documentation for ZimaOS](https://www.twingate.com/docs/zimaos-getting-started). **Community Support** If you have any questions or need help with the Twingate Connector, you can reach out on the [Twingate subreddit](https://www.reddit.com/r/twingate/). From 70b3ff62a6cacc237176241a9df269c99077554e Mon Sep 17 00:00:00 2001 From: Andrew Baumbach Date: Fri, 24 Apr 2026 16:39:10 -0400 Subject: [PATCH 5/5] chore: minor copy tweaks --- Apps/Twingate/docker-compose.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Apps/Twingate/docker-compose.yml b/Apps/Twingate/docker-compose.yml index 767f9cc0e..e8bfef625 100644 --- a/Apps/Twingate/docker-compose.yml +++ b/Apps/Twingate/docker-compose.yml @@ -35,7 +35,7 @@ services: deploy: resources: reservations: - memory: 500M # Modify as needed since the original command didn't specify memory reservation + memory: 500M # Modify as needed x-casaos: architectures: @@ -46,7 +46,7 @@ x-casaos: author: Shubhankar Trivedi category: Network description: - en_us: "Install the Twingate Connector on ZimaOS to securely connect your home network to the Twingate network. This allows you to access your home network resources from anywhere without exposing them to the internet." + en_us: "Install the Twingate Connector on ZimaOS to securely connect your home network to a Twingate Network. This allows you to access your home network resources from anywhere without exposing them to the internet." developer: Twingate icon: https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Twingate/icon.png screenshot_link: