[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"content:page:/en/instructions/linux-connect":3,"content:related:/en/instructions/linux-connect":365,"md:/en/_partials/links":531},{"page":4,"locales":360},{"title":5,"description":6,"path":7,"created":8,"updated":9,"tags":10,"minutes":13,"author":14,"cover":15,"coverSmall":16,"body":17},"How to Connect a VPN on Linux","Set up Happ on Linux: choose a package and architecture, install a DEB, import your subscription and check the connection. Troubleshooting.","/en/instructions/linux-connect","2026-01-27 14:27:16","2026-10-25 17:45:03",[11,12],"Connection","Linux",6,null,"/client/images/articles/covers/linux-connect.webp?v=833c31ff","/client/images/articles/covers/linux-connect-960.webp?v=008a62d9",{"type":18,"value":19,"toc":354},"minimark",[20,30,33,38,45,48,63,66,72,95,107,110,130,133,149,158,161,178,182,197,206,233,241,244,254,260,263,268,274,277,303,309,312,319,323,334,337,346,350],[21,22,23,24,29],"p",{},"To connect through Happ on Linux, install a package for your distribution and architecture, import a valid subscription and select a server. The setup below uses a subscription to VPNON, our service. ",[25,26,28],"md-link",{"to":27},"https://www.happ.su/main","Happ itself does not provide servers",".",[21,31,32],{},"Sources were read on 25 October 2026. The build number in the retained illustrations has not been established. The images do not confirm button locations in the current release. Package installation and a Linux connection were not tested as part of this review.",[34,35,37],"h2",{"id":36},"connecting-on-linux","Connecting on Linux",[21,39,40,41,44],{},"In ",[25,42,43],{"to":27},"Happ’s official list",", Linux packages are available as DEB, RPM and pkg.tar.zst, with x64 and arm64 variants. Choose the format for your distribution and system architecture. The installation procedure below covers DEB packages on Debian/Ubuntu with APT. For other formats, use your distribution’s documentation.",[21,46,47],{},"The illustrated setup requires a graphical desktop and a valid subscription or configuration from a provider. Installing the app alone does not add servers. Check compatibility between the selected Happ release and your system separately.",[49,50,51,57],"ul",{},[52,53,54],"li",{},[25,55,56],{"to":27},"Official website",[52,58,59],{},[25,60,62],{":to":61},"HAPP_DESKTOP_LINUX_DEB","Direct installation",[21,64,65],{},"For Debian/Ubuntu with APT:",[67,68,69],"ol",{},[52,70,71],{},"Open a terminal and check the system’s package architecture:",[73,74,79],"pre",{"className":75,"code":76,"language":77,"meta":78,"style":78},"language-bash shiki shiki-themes github-light github-dark","dpkg --print-architecture\n","bash","",[80,81,82],"code",{"__ignoreMap":78},[83,84,87,91],"span",{"class":85,"line":86},"line",1,[83,88,90],{"class":89},"sScJk","dpkg",[83,92,94],{"class":93},"sj4cs"," --print-architecture\n",[67,96,98,101,104],{"start":97},2,[52,99,100],{},"Download the DEB from Happ’s official list according to the result: the x64 file for amd64, or the arm64 file for arm64. For another architecture, first check whether a suitable build is available.",[52,102,103],{},"Open a terminal in the folder containing the downloaded file.",[52,105,106],{},"Run only one command, matching your file.",[21,108,109],{},"For Happ.linux.x64.deb:",[73,111,113],{"className":75,"code":112,"language":77,"meta":78,"style":78},"sudo apt install ./Happ.linux.x64.deb\n",[80,114,115],{"__ignoreMap":78},[83,116,117,120,124,127],{"class":85,"line":86},[83,118,119],{"class":89},"sudo",[83,121,123],{"class":122},"sZZnC"," apt",[83,125,126],{"class":122}," install",[83,128,129],{"class":122}," ./Happ.linux.x64.deb\n",[21,131,132],{},"For Happ.linux.arm64.deb:",[73,134,136],{"className":75,"code":135,"language":77,"meta":78,"style":78},"sudo apt install ./Happ.linux.arm64.deb\n",[80,137,138],{"__ignoreMap":78},[83,139,140,142,144,146],{"class":85,"line":86},[83,141,119],{"class":89},[83,143,123],{"class":122},[83,145,126],{"class":122},[83,147,148],{"class":122}," ./Happ.linux.arm64.deb\n",[67,150,152,155],{"start":151},5,[52,153,154],{},"Read APT’s proposed list of changes. Confirm only the expected installation. If it proposes unexpected removals or reports an error, stop and save the message.",[52,156,157],{},"Wait for installation to finish successfully. Then continue to app setup.",[21,159,160],{},"If the downloaded file has a different name, use its actual name. The ./ prefix refers to a file in the current folder. If sudo asks for a password, enter it only at the standard terminal prompt and do not send it to anyone.",[21,162,163,164,168,169,173,174,29],{},"The general syntax for installing a local DEB is described in ",[25,165,167],{"to":166},"https://ubuntu.com/server/docs/tutorial/managing-software/","Ubuntu’s guide",". The architecture check is documented in the ",[25,170,172],{"to":171},"https://manpages.debian.org/trixie/dpkg/dpkg.1.en.html","dpkg manual",", and the amd64/x64 and arm64 names in ",[25,175,177],{"to":176},"https://documentation.ubuntu.com/project/how-ubuntu-is-made/concepts/supported-architectures/","Ubuntu’s documentation",[34,179,181],{"id":180},"app-setup","App Setup",[67,183,184],{},[52,185,186,187,191,192,196],{},"On the same computer, click ",[188,189,190],"strong",{},"Copy subscription"," in your ",[25,193,195],{"to":194},"/cabinet","account",". Copy the access data, not the account page’s address. Do not publish your subscription link.",[21,198,199],{},[200,201],"img",{"alt":202,"src":203,"width":204,"height":205},"Copy subscription button in a VPNON account","/client/images/articles/en/instructions/linux-connect.webp",1270,444,[67,207,208,211],{"start":97},[52,209,210],{},"Open the installed Happ app.",[52,212,213,214,217,218,228,229,29],{},"In the illustrated ",[188,215,216],{},"Insert"," window, place the cursor in the field and paste the copied subscription using ",[219,220,221,224,225],"kbd",{},[219,222,223],{},"Ctrl"," + ",[219,226,227],{},"V",". If your screen differs, find clipboard import in the ",[25,230,232],{"to":231},"https://www.happ.su/main/faq/adding-configuration-subscription","documentation for your version",[21,234,235],{},[200,236],{"alt":237,"src":238,"width":239,"height":240},"Field in the illustrated Happ Insert window on Linux","/client/images/articles/en/instructions/linux-connect-1.webp",1280,720,[21,242,243],{},"Interface illustration; the build number has not been established.",[67,245,247],{"start":246},4,[52,248,249,250,253],{},"In the interface shown, click ",[188,251,252],{},"Get started"," to add the subscription. If the button is missing or import fails, consult the documentation for your version and check the copied data.",[21,255,256],{},[200,257],{"alt":258,"src":259,"width":239,"height":240},"Get started button for importing a subscription into Happ on Linux","/client/images/articles/en/instructions/linux-connect-2.webp",[21,261,262],{},"A demonstration address is shown, not a working subscription.",[67,264,265],{"start":151},[52,266,267],{},"Wait for the added subscription’s servers to appear and select a server provided to you. In the retained illustration, the list is on the left. If the list is empty or there is a download error, first check the import and the validity of your access with the provider.",[21,269,270],{},[200,271],{"alt":272,"src":273,"width":239,"height":240},"Server list and selected TUN mode in Happ on Linux","/client/images/articles/en/instructions/linux-connect-3.webp",[21,275,276],{},"Example server list; the location and traffic counter do not define the current plan’s terms.",[67,278,279,294,297,300],{"start":13},[52,280,281,282,285,286,289,290,293],{},"The illustrations show ",[188,283,284],{},"TUN"," selected. Before connecting, check the ",[188,287,288],{},"Proxy/TUN"," mode and routing profile against the ",[25,291,232],{"to":292},"https://www.happ.su/main/ru/dev-docs/app-management.md"," and your subscription’s terms. Do not automatically copy the mode selected in the image.",[52,295,296],{},"Click the large button with the power symbol.",[52,298,299],{},"If the system requests privileges for a network component, read the request and confirm only the expected action of the installed app. On a work or school computer, agree on the change with the administrator.",[52,301,302],{},"Wait for Happ to show a connected state and perform one required action on a site or in an app you are allowed to access. A “connected” status alone does not guarantee access to every resource or handling of every program’s traffic. If the action fails, continue with the troubleshooting below.",[21,304,305],{},[200,306],{"alt":307,"src":308,"width":239,"height":240},"CONNECTED status in Happ on Linux","/client/images/articles/en/instructions/linux-connect-4.webp",[21,310,311],{},"A connected status is shown; this does not test every resource or program.",[21,313,314,315,29],{},"The effect of the routing profile is described in the ",[25,316,318],{"to":317},"https://github.com/Happ-proxy/happ-desktop/releases/tag/4.5.4","Happ Desktop 4.5.4 release notes",[34,320,322],{"id":321},"if-happ-will-not-install-or-connect","If Happ Will Not Install or Connect",[67,324,325,328,331],{},[52,326,327],{},"If installation fails, check the package format, architecture and exact package manager message. Do not suppress the error with a forced installation or remove system packages to continue.",[52,329,330],{},"If the app will not launch, record your distribution, its version and the Happ version. Check compatibility with the developer. Do not disable system protection based on an arbitrary guide.",[52,332,333],{},"If the subscription will not load or there is no connection, check regular internet access without VPN, the validity of your access and the selected profile. If possible, repeat the check on another network. Save the exact error and contact your access provider or the client developer.",[21,335,336],{},"Do not publish subscription links, keys, passwords or a full log containing secrets. Agree on changes to a managed device with its administrator.",[21,338,339,340,342,343,29],{},"Check installation against ",[25,341,177],{"to":166}," and import against ",[25,344,345],{"to":231},"Happ’s guidance",[347,348],"md-include",{"path":349},"/_partials/links",[351,352,353],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":78,"searchDepth":355,"depth":97,"links":356},3,[357,358,359],{"id":36,"depth":97,"text":37},{"id":180,"depth":97,"text":181},{"id":321,"depth":97,"text":322},[361,362,363,364],"ru","en","id","tr",[366,380,394,407,425,437,450,463,477,489,502,517],{"title":367,"description":368,"path":369,"created":8,"updated":370,"tags":371,"minutes":151,"author":14,"cover":373,"coverSmall":374,"coverFocus":375,"lead":378,"pinned":379},"How to Connect a VPN on macOS","Set up Happ on Mac: compare App Store and DMG options, import your subscription, choose a server and check the connection. Common issues.","/en/instructions/macos-connect","2026-10-25 17:10:24",[11,372],"MacOS","/client/images/articles/covers/macos-connect.webp?v=5b5221fd","/client/images/articles/covers/macos-connect-960.webp?v=0e1ec72c",[376,377],76.7,47.7,"To connect through Happ on Mac, in tall a  uitable app variant, import a valid  ub cription and  elect a  erver. The  etup below u e  a  ub cription to VPNON, our  ervice. Happ it elf doe  not provide  erver . Source  were read on 25 October 2026. The build number and in tallation method of the app in the retained illu",false,{"title":381,"description":382,"path":383,"created":384,"updated":385,"tags":386,"minutes":246,"author":14,"cover":388,"coverSmall":389,"coverFocus":390,"lead":393,"pinned":379},"How to Connect a VPN on iOS","Set up Happ on iPhone: check compatibility, install the app, import a subscription, choose a server and verify the connection. Common issues.","/en/instructions/ios-connect","2026-01-28 13:54:10","2026-10-25 16:26:18",[11,387],"IOS","/client/images/articles/covers/ios-connect.webp?v=b67ca923","/client/images/articles/covers/ios-connect-960.webp?v=c1398456",[391,392],78.3,45.2,"To connect through Happ on iPhone, in tall the app, add a valid  ub cription from your provider and  elect a  erver. The  etup below u e  a  ub cription to VPNON, our  ervice. Happ it elf doe  not provide  erver . Source  were read on 25 October 2026. The illu tration  retain an interface who e build number ha  not",{"title":395,"description":396,"path":397,"created":8,"updated":398,"tags":399,"minutes":97,"author":14,"cover":401,"coverSmall":402,"coverFocus":403,"lead":406,"pinned":379},"How to Connect a VPN on Windows","Install Happ on Windows, import your VPNON subscription link, select a server and check the connection. Troubleshoot import and website access issues.","/en/instructions/windows-connect","2026-11-06 17:58:38",[11,400],"Windows","/client/images/articles/covers/windows-connect.webp?v=cf2f9588","/client/images/articles/covers/windows-connect-960.webp?v=e957fda1",[404,405],77.8,45.8,"To connect to VPNON on Window , in tall Happ, add the  ub cription link from your account,  elect a  erver and  tart the connection. Happ i  a client; in talling the app doe  not it elf provide acce  to  erver . Before in talling, check the  upported Window  ver ion and computer architecture again t the requirement  of",{"title":408,"description":409,"path":410,"created":411,"updated":412,"tags":413,"minutes":417,"author":418,"cover":419,"coverSmall":420,"coverFocus":421,"lead":424,"pinned":379},"How to install Happ VPN on mobile, desktop and TV","Happ downloads for seven platforms, build selection and subscription import. Check installation, TV transfer and connection results before troubleshooting.","/en/blog/how-to-install-happ-vpn-all-platforms","2026-07-15 13:45:00","2026-10-17 23:16:11",[414,415,416],"VPN","Happ","Help",14,"adam-jensen","/client/images/articles/covers/how-to-install-happ-vpn-all-platforms.webp?v=d0123a0e","/client/images/articles/covers/how-to-install-happ-vpn-all-platforms-960.webp?v=1960ac79",[422,423],71.3,37.7,"In tall Happ from the developer’   ource for your  y tem. Then add the configuration or  ub cription you received and check the action you need. Separate  tep  below cover Window , Android, Android TV, iOS, macOS, Apple TV and Linux. Happ i  a client; obtain  erver acce   eparately or u e your own  erver. Start by",{"title":426,"description":427,"path":428,"created":8,"updated":429,"tags":430,"minutes":13,"author":14,"cover":432,"coverSmall":433,"coverFocus":434,"lead":436,"pinned":379},"How to Connect a VPN on Android TV","Set up Happ on Android TV: install the app, transfer a subscription from your phone by QR code, choose a server and check the connection.","/en/instructions/androidtv-connect","2026-10-26 00:00:44",[11,431],"AndroidTV","/client/images/articles/covers/androidtv-connect.webp?v=558aa3cb","/client/images/articles/covers/androidtv-connect-960.webp?v=7a9842d5",[435,377],78.5,"To connect on Android TV, in tall Happ, tran fer an active  ub cription from Happ on your phone and choo e a  erver. The example below u e  VPNON, our  ervice. Happ it elf doe  not provide  erver . Source  were read on 25–26 October 2026. The build number in the retained illu tration  ha  not been e tabli hed. They do",{"title":438,"description":439,"path":440,"created":8,"updated":441,"tags":442,"minutes":13,"author":14,"cover":444,"coverSmall":445,"coverFocus":446,"lead":449,"pinned":379},"How to Connect a VPN on Apple TV","Set up Happ on Apple TV: check tvOS requirements, install the TV app, transfer a subscription from your phone and test the connection. Fixes.","/en/instructions/appletv-connect","2026-10-25 23:43:13",[11,443],"AppleTV","/client/images/articles/covers/appletv-connect.webp?v=8f9bd542","/client/images/articles/covers/appletv-connect-960.webp?v=2b960b41",[447,448],66.9,41.9,"To connect on an Apple TV device, in tall Happ for tvOS, tran fer an active  ub cription from Happ on your phone and choo e a  erver. The example below u e  VPNON, our  ervice. Happ it elf doe  not provide  erver . Source  were read on 25 October 2026. The build number in the retained illu tration  ha  not been e tabli",{"title":451,"description":452,"path":453,"created":8,"updated":454,"tags":455,"minutes":355,"author":14,"cover":457,"coverSmall":458,"coverFocus":459,"lead":462,"pinned":379},"How to Connect a VPN on Android","Install Happ on Android, import your VPNON subscription, select a server and approve the VPN request. Check import failures and website access issues.","/en/instructions/android-connect","2026-11-06 18:11:52",[11,456],"Android","/client/images/articles/covers/android-connect.webp?v=2e4bd51f","/client/images/articles/covers/android-connect-960.webp?v=5c9a5657",[460,461],72,42.2,"To connect to VPNON on Android, in tall Happ, add the  ub cription link from your account,  elect a  erver and  tart the connection. Happ i  a client; in talling the app doe  not it elf provide acce  to  erver . Before in talling, check the requirement  of the Happ relea e you cho e and the file  ource. If Google Play",{"title":464,"description":465,"path":466,"created":467,"updated":468,"tags":469,"minutes":470,"author":418,"cover":471,"coverSmall":472,"coverFocus":473,"lead":476,"pinned":379},"Happ not working: 10 causes and checks","Happ will not connect: check subscriptions, TUN, DNS and routes on iOS, Android and Windows. Record errors and compare connection attempts.","/en/blog/10-reasons-happ-not-working","2026-07-02 10:00:00","2026-10-19 22:49:40",[414,415,416],20,"/client/images/articles/covers/10-reasons-happ-not-working.webp?v=96c03755","/client/images/articles/covers/10-reasons-happ-not-working-960.webp?v=331b2878",[474,475],65.6,37.8,"If Happ will not connect, fir t identify the  tage of the error: importing a configuration,  tarting the connection or performing the action you need. An empty  erver li t and a web ite that will not open after connecting require different check . A VPN icon alone doe  not e tabli h that a web ite or app work . Record",{"title":478,"description":479,"path":480,"created":8,"updated":481,"tags":482,"minutes":355,"author":14,"cover":483,"coverSmall":484,"coverFocus":485,"lead":488,"pinned":379},"Happ: server list and routing issues","Check missing servers and routing issues in Happ: subscription updates, the selected routing profile, connection checks and what to send to support.","/en/instructions/faq","2026-11-06 18:26:59",[416,11],"/client/images/articles/covers/faq.webp?v=dc6929ac","/client/images/articles/covers/faq-960.webp?v=7186283b",[486,487],71.4,38.7,"If Happ doe  not  how  erver , fir t check whether  ub cription data i  being received. If routing doe  not behave a  expected, check the  elected profile and expected traffic path. Updating the  erver li t and checking routing are different action ; a  ucce ful update alone doe  not e tabli h that the connection work",{"title":490,"description":491,"path":492,"created":493,"updated":494,"tags":495,"minutes":496,"author":418,"cover":497,"coverSmall":498,"coverFocus":499,"lead":501,"pinned":379},"Happ VPN for free: subscriptions and configs","What is free in Happ and where connection settings come from. Check subscription terms, import a config and keep your private link confidential.","/en/blog/how-to-use-happ-vpn-for-free","2026-07-22 14:10:00","2026-10-20 04:56:30",[414,415,416],18,"/client/images/articles/covers/how-to-use-happ-vpn-for-free.webp?v=3b2edb99","/client/images/articles/covers/how-to-use-happ-vpn-for-free-960.webp?v=c6e731b4",[500,475],70.5,"You can in tall Happ for free, but the app doe  not  upply  erver . To connect, add a compatible configuration for your own  erver or your cho en provider. Unpaid acce  i  po ible if the operator offer  it; a paid trial i  not free acce . Fir t check the app'   ource, the  erver acce  term  and format  upport in your",{"title":503,"description":504,"path":505,"created":506,"updated":507,"tags":508,"minutes":510,"author":418,"cover":511,"coverSmall":512,"coverFocus":513,"lead":516,"pinned":379},"What Is Happ VPN and How Does It Work?","Learn what Happ VPN is, how it works, which protocols it supports, how it differs from traditional VPN services, and who it is designed for.","/en/blog/what-is-happ-vpn-and-how-it-works","2026-07-08 13:12:06","2026-10-17 18:30:00",[414,415,509],"Basics",8,"/client/images/articles/covers/what-is-happ-vpn-and-how-it-works.webp?v=34cf92c6","/client/images/articles/covers/what-is-happ-vpn-and-how-it-works-960.webp?v=e17446be",[514,515],77.9,46.1,"Happ i  a client for connecting to configured  erver . The developer  tate  that the app doe  not provide it  own VPN  ervice. To connect, you need  etting  for your own  erver or a configuration from an acce  provider. Start by identifying your platform and client ver ion. Then check who  upplied the configuration and",{"title":518,"description":519,"path":520,"created":521,"updated":522,"tags":523,"minutes":524,"author":418,"cover":525,"coverSmall":526,"coverFocus":527,"lead":530,"pinned":379},"VPN for PC: choosing, setup, and checks","A practical guide to choosing a VPN for your computer: protocols, speed, security, setup on Windows, and common troubleshooting points","/en/blog/vpn-for-pc-how-to-choose-and-set-up","2026-04-18 12:00:00","2026-10-16 12:00:00",[414,509],9,"/client/images/articles/covers/vpn-for-pc-how-to-choose-and-set-up.webp?v=9f8c2f91","/client/images/articles/covers/vpn-for-pc-how-to-choose-and-set-up-960.webp?v=3b3775af",[528,529],66.6,41.4,"A VPN route   elected connection  through a VPN  erver. The protected tunnel encrypt  traffic between your computer and that  erver. The re ult for the app you need depend  on routing and  etting ; a connection icon alone doe  not confirm acce  to every  ervice. Fir t identify the connection method: a  eparate app or a",{"body":532},{"type":18,"value":533,"toc":571},[534,539],[21,535,536],{},[188,537,538],{},"Useful links:",[49,540,541,547,553,559],{},[52,542,543],{},[25,544,546],{":to":545},"TELEGRAM_SUPPORT","Support — Telegram",[52,548,549],{},[25,550,552],{":to":551},"TELEGRAM_BOT","Service Bot — Telegram",[52,554,555],{},[25,556,558],{":to":557},"TELEGRAM_CHANNEL","Channel — Telegram",[52,560,561,565,566,570],{},[25,562,564],{":to":563},"TELEGRAM_MTPROXY","Free MTProxy for Telegram"," (",[25,567,569],{":to":568},"/blog/what-is-mtproto-proxy","What's it?",")",{"title":78,"searchDepth":355,"depth":97,"links":572},[]]