{"id":1168,"date":"2020-01-01T22:41:53","date_gmt":"2020-01-01T21:41:53","guid":{"rendered":"https:\/\/www.torbox.ch\/?page_id=1168"},"modified":"2026-03-31T21:47:01","modified_gmt":"2026-03-31T20:47:01","slug":"installation","status":"publish","type":"page","link":"https:\/\/www.torbox.ch\/?page_id=1168","title":{"rendered":"Installation &#8211; TorBox"},"content":{"rendered":"\n<p>There are three different ways to install TorBox on a <a href=\"https:\/\/www.raspberrypi.org\/products\/raspberry-pi-3-model-b-plus\/\">Raspberry Pi 3&nbsp;Model B+<\/a>, a&nbsp;<a href=\"https:\/\/www.raspberrypi.org\/products\/raspberry-pi-4-model-b\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi 4 Model B<\/a> or a <a href=\"https:\/\/www.raspberrypi.com\/news\/introducing-raspberry-pi-5\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi 5<\/a>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.torbox.ch\/?page_id=1168#image_raspi\">Using our image file (this is the recommended default way)<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.torbox.ch\/?page_id=1168#script\">Using our installation script<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.torbox.ch\/?page_id=1168#scratch\">Installation from scratch<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/www.torbox.ch\/?page_id=1168#addendum001\">Addendum: How to connect to a wireless network from the CLI?<\/a><\/li>\n<\/ul>\n\n\n\n<p>There are <a href=\"https:\/\/www.torbox.ch\/?page_id=1168#others\">additional installation scripts for other systems<\/a>, which may also run on different hardware platforms. However, TorBox&#8217;s implementation on other systems and hardware is experimental because we lack the resources to verify all the details across various installations. You can help us with reporting errors back to us.<\/p>\n\n\n\n<h1><p style=\"text-align: center;\">\u2022 \u2022 \u2022<\/p><\/h1>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"image_raspi\">Using our image file on a Raspberry Pi (recommended!)<\/h5>\n\n\n\n<p>This is the recommended and probably most straightforward way to install TorBox on a Raspberry Pi:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.torbox.ch\/data\/torbox-20260322-v055.img.xz\">Download the latest TorBox image<\/a>\u00a0(<strong>TorBox v.0.5.5\u00a0<\/strong>based on\u00a0<a href=\"https:\/\/www.raspberrypi.com\/software\/operating-systems\/#raspberry-pi-os-64-bit\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi OS \u201cTrixie\u201d lite 64bit<\/a>\u00a0with the\u00a0<a href=\"https:\/\/kernelnewbies.org\/Linux_6.12\" target=\"_blank\" rel=\"noreferrer noopener\">Linux Kernel 6.12.75<\/a>\u00a0and\u00a0<a href=\"https:\/\/gitlab.torproject.org\/tpo\/core\/tor\/-\/raw\/release-0.4.9\/ReleaseNotes\" target=\"_blank\" rel=\"noreferrer noopener\">Tor version 0.4.9.5<\/a>\u00a0with\u00a0<a href=\"https:\/\/salsa.debian.org\/pkg-privacy-team\/obfs4proxy\/-\/blob\/master\/ChangeLog\" target=\"_blank\" rel=\"noreferrer noopener\">obfs4proxy version 0.0.14<\/a>\u00a0and\u00a0<a href=\"https:\/\/gitlab.torproject.org\/tpo\/anti-censorship\/pluggable-transports\/snowflake\/-\/blob\/main\/ChangeLog\">Snowflake 2.12.1<\/a>; ~2 GB) and\u00a0<a href=\"https:\/\/www.torbox.ch\/?page_id=1128\" target=\"_blank\" rel=\"noreferrer noopener\">verify the integrity of the downloaded file<\/a>.<\/li>\n\n\n\n<li>Transfer the downloaded image file to a\u00a0<a href=\"https:\/\/en.wikipedia.org\/wiki\/Secure_Digital\" target=\"_blank\" rel=\"noreferrer noopener\">SD Card<\/a>. Due to the significantly improved compression rate, we compress the images using\u00a0<a href=\"https:\/\/en.wikipedia.org\/wiki\/XZ_Utils\" target=\"_blank\" rel=\"noreferrer noopener\">xz<\/a>. By default,\u00a0<a href=\"https:\/\/etcher.balena.io\/\" target=\"_blank\" rel=\"noreferrer noopener\">Balena Etcher<\/a>\u00a0and\u00a0<a href=\"https:\/\/www.raspberrypi.com\/software\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Imager<\/a>\u00a0support this kind of compressed image, but sometimes one or the other fails with an error message to flash it correctly on a SD Card. In this case,\u00a0<a href=\"https:\/\/kagi.com\/assistant\/dd4e22e4-7706-489c-b33d-4c17d02cc96d\" target=\"_blank\" rel=\"noreferrer noopener\">you need to decompress the .xz file first<\/a>. TorBox needs at least a 16 GB SD Card.<\/li>\n\n\n\n<li>Put the SD Card into your Raspberry Pi, link it with an Internet router using an Ethernet cable, or place an USB WiFi adapter in one of the USB ports to use an existing WiFi. Afterwards, start the Raspberry Pi. At startup, the system on the SD card automatically expands to fill the entire free partition; user interaction, screens, and peripherals are not required yet.<\/li>\n\n\n\n<li>After 2-3 minutes, when the green LED stops flickering, connect your client to the new WiFi \u201cTorBox055\u201d (password:&nbsp;<strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>Login to the TorBox by using a\u00a0<a href=\"https:\/\/www.torbox.ch\/?page_id=112#which-ssh-client-do-you-prefer\" target=\"_blank\" rel=\"noreferrer noopener\">SSH client<\/a>\u00a0(<strong>192.168.42.1<\/strong>\u00a0on a WiFi client,\u00a0<strong>192.168.43.1<\/strong>\u00a0on a cable client or\u00a0<a href=\"http:\/\/192.168.44.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">192.168.44.1<\/a>\u00a0when connected via VPN or if you use\u00a0<a href=\"https:\/\/www.torbox.ch\/?page_id=3544\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox mini<\/a>\u00a0on a\u00a0<a href=\"https:\/\/www.raspberrypi.com\/products\/raspberry-pi-zero-2-w\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Zero 2 W<\/a>\u00a0as a RNDIS\/Ethernet Gadget) or a web browser (<a href=\"http:\/\/192.168.42.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/192.168.42.1<\/a>\u00a0on a WiFi client,\u00a0<a href=\"http:\/\/192.168.43.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/192.168.43.1<\/a>\u00a0on a cable client or\u00a0<a href=\"http:\/\/192.168.44.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">192.168.44.1<\/a>\u00a0when connected via VPN or using TorBox mini; username:\u00a0<strong>torbox<\/strong>\u00a0\/ password:\u00a0<strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>After&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=2637\" target=\"_blank\" rel=\"noreferrer noopener\">seeing a welcome screen and answering some initial questions during the first start-up<\/a>, you should see the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=775\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox Main Menu<\/a>. Immediately, you should&nbsp;<strong>change the default passwords<\/strong>&nbsp;(the associated entries are placed in the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=875\" target=\"_blank\" rel=\"noreferrer noopener\">configuration sub-menu<\/a>).<\/li>\n<\/ol>\n\n\n\n<p>We recommend running TorBox on a&nbsp;<strong><a href=\"https:\/\/www.raspberrypi.org\/products\/raspberry-pi-3-model-b-plus\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi 3 Model B+<\/a><\/strong>, a&nbsp;<strong><a href=\"https:\/\/www.raspberrypi.org\/products\/raspberry-pi-4-model-b\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi 4 Model B<\/a><\/strong>&nbsp;or a&nbsp;<strong><a href=\"https:\/\/www.raspberrypi.com\/products\/raspberry-pi-5\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi 5<\/a><\/strong>. We also offer&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=1168\" target=\"_blank\" rel=\"noreferrer noopener\">installation scripts for other systems<\/a>, which might run on older (32-bit) or other hardware platforms.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><a href=\"https:\/\/www.torbox.ch\/wp-content\/uploads\/2025\/12\/TorBox-A5-RPI5-055.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"722\" src=\"https:\/\/www.torbox.ch\/wp-content\/uploads\/2025\/12\/TorBox-A5-RPI5-055-1024x722.png\" alt=\"\" class=\"wp-image-3997\"\/><\/a><\/figure>\n<\/div>\n\n\n<h1><p style=\"text-align: center;\">\u2022 \u2022 \u2022<\/p><\/h1>\n\n\n\n<p><a name=\"iscript\"><\/a><\/p>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"script\">Using our installation script on a Raspberry Pi with Raspberry Pi OS Lite<\/h5>\n\n\n\n<p>This is likely the most efficient method for installing TorBox. With that method, you will have the latest versions of the base system and the TorBox menu, and won&#8217;t have to wait for the next image release.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Download&nbsp;the latest version of <a href=\"https:\/\/www.raspberrypi.com\/software\/operating-systems\/#raspberry-pi-os-64-bit\">Raspberry Pi OS Lite (64-bit)<\/a>&nbsp;or <a href=\"https:\/\/www.raspberrypi.com\/software\/operating-systems\/\">Raspberry Pi OS Lite (32-bit)<\/a>, or use the&nbsp;<a href=\"https:\/\/github.com\/raspberrypi\/rpi-imager\/releases\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Imager<\/a>&nbsp;and choose, under <code>Operating System<\/code>, <code>Raspberry Pi OS (other)<\/code>, <code>Raspberry Pi OS Lite (64-bit)<\/code> or <code>Raspberry Pi OS Lite (32-bit)<\/code> image.<\/li>\n\n\n\n<li>If you don&#8217;t use the Raspberry Pi Imager, then transfer the downloaded Raspberry Pi OS Lite image to an&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Secure_Digital\" target=\"_blank\" rel=\"noreferrer noopener\">SD Card<\/a>, for example, with&nbsp;<a href=\"https:\/\/www.balena.io\/etcher\/\" target=\"_blank\" rel=\"noreferrer noopener\">Etcher<\/a>. <strong>TorBox needs at least a 16 GB SD Card.<\/strong><\/li>\n\n\n\n<li>If asked, create a user &#8220;<strong>torbox<\/strong>&#8221; and remember the chosen password for later use.<\/li>\n\n\n\n<li>Optionally, localise your installation.<\/li>\n\n\n\n<li>Ensure stable Internet connectivity, download and execute our installation script (for options, use&nbsp;<code>--help<\/code>):<\/li>\n<\/ol>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: bash; title: ; notranslate\" title=\"\">\ncd\nwget https:\/\/raw.githubusercontent.com\/radio24\/TorBox\/master\/install\/run_install.sh\nchmod a+x run_install.sh  \n.\/run_install.sh \n<\/pre><\/div>\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>The installation script supports the following options:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\nSyntax : run_install.sh &#x5B;-h|--help] &#x5B;--randomize_hostname] &#x5B;--select-tor] &#x5B;--select-fork fork_owner_name] &#x5B;--select-branch branch_name] &#x5B;--on_a_cloud] &#x5B;--torbox_mini] &#x5B;--continue_with_step n] &#x5B;--step_by_step]\nOptions: -h, --help     : Shows this help screen ;-)\n         --randomize_hostname\n                        : Randomizes the hostname to prevent ISPs to see the default\n         --select-tor   : Let select a specific tor version (default: newest stable version)\n         --select-fork fork_owner_name\n\t\t\t            : Let select a specific fork from a GitHub user (fork_owner_name)\n         --select-branch branch_name\n                        : Let select a specific TorBox branch (default: master)\n         --on_a_cloud   : Installing on a cloud or as a cloud service\n         --torbox_mini  : Installing TorBox mini on a Raspberry Pi Zero 2 W\n         --step_by_step : Executes the installation step by step\n         --continue_with_step n\n                        : Continue the installation with a certain step\n<\/pre><\/div>\n\n\n<div style=\"height:60px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ol start=\"6\" class=\"wp-block-list\">\n<li>Restart the system; after 2-3 minutes, when the green LED stops flickering, connect your client to the new WiFi &#8220;TorBox055&#8221; (password:&nbsp;<strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>Login to the TorBox by using a&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=112#which-ssh-client-do-you-prefer\" target=\"_blank\" rel=\"noreferrer noopener\">SSH client<\/a>&nbsp;(<strong>192.168.42.1<\/strong>&nbsp;on a WiFi client,&nbsp;<strong>192.168.43.1<\/strong>&nbsp;on a cable client or&nbsp;<strong>192.168.44.1<\/strong>&nbsp;when connected via VPN or if you use&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=3544\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox mini<\/a>&nbsp;on a&nbsp;<a href=\"https:\/\/www.raspberrypi.com\/products\/raspberry-pi-zero-2-w\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Zero 2 W<\/a>&nbsp;as a RNDIS\/Ethernet Gadget) or a web browser (<a href=\"http:\/\/192.168.42.1\">http:\/\/192.168.42.1 <\/a> on a WiFi client,&nbsp;<a href=\"http:\/\/192.168.43.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/192.168.43.1<\/a>&nbsp;on a cable client or&nbsp;<a href=\"http:\/\/192.168.44.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">192.168.44.1<\/a>&nbsp;when connected via VPN or using TorBox mini; username:&nbsp;<strong>torbox<\/strong>&nbsp;\/ and your chosen password (if no login\/pasword was asked, try <strong>torbox<\/strong>\/ <strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>After <a href=\"https:\/\/www.torbox.ch\/?page_id=2637\">seeing a welcome screen and answering some initial questions during the first start-up<\/a>, you should see the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=775\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox Main Menu<\/a>. Immediately, you should&nbsp;<strong>change the default passwords<\/strong>&nbsp;(the associated entries are placed in the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=875\" target=\"_blank\" rel=\"noreferrer noopener\">configuration sub-menu<\/a>.<\/li>\n<\/ol>\n\n\n\n<h1><p style=\"text-align: center;\">\u2022 \u2022 \u2022<\/p><\/h1>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"others\">Using scripts for other systems and hardware platforms<\/h5>\n\n\n\n<p>We tested the installation only on a Raspberry Pi 4 and a Raspberry Pi 5, but it should also work on an older Raspberry Pi if the correct image is used:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Operating System<\/strong><\/td><td><strong>OS image<\/strong><\/td><td><strong>Script<\/strong><\/td><td><strong>Remarks &amp; Restrictions<\/strong><\/td><\/tr><tr><td>Debian 13 (Trixie)<br><br><strong>Important: <\/strong><br><strong>Currently, Debian Images <a href=\"https:\/\/raspi.debian.net\/faq\/#faq-rpi5\">are not working with the Raspberry Pi 5<\/a><\/strong>.<\/td><td><a href=\"https:\/\/raspi.debian.net\/tested-images\/\">Raspberry Pi Debian Images<\/a><\/td><td><a href=\"https:\/\/raw.githubusercontent.com\/radio24\/TorBox\/master\/install\/run_install_on_debian.sh\">run_install_on_debian.sh<\/a><br>(installation script for Debian-based systems)<\/td><td>\u2794 see Footnotes 1<\/td><\/tr><tr><td>Debian 13 (Trixie)<br><\/td><td><a href=\"https:\/\/dietpi.com\/#download\">DietPi image download<\/a><br>(<strong>Important<\/strong>: <a href=\"https:\/\/dietpi.com\/docs\/hardware\/\" target=\"_blank\" rel=\"noreferrer noopener\">Check this compatibility list<\/a>)<\/td><td><a href=\"https:\/\/raw.githubusercontent.com\/radio24\/TorBox\/master\/install\/run_install_on_debian.sh\">run_install_on_debian.sh<\/a><br>(installation script for Debian-based systems)<\/td><td>\u2794 see Footnotes 2<\/td><\/tr><tr><td>Ubuntu Server 24.04 LTS<\/td><td><a href=\"https:\/\/ubuntu.com\/download\/raspberry-pi\">Ubuntu&nbsp;on a Raspberry Pi<\/a><br>or use the <a rel=\"noreferrer noopener\" href=\"https:\/\/github.com\/raspberrypi\/rpi-imager\/releases\" target=\"_blank\">Raspberry Pi Imager<\/a>&nbsp;<\/td><td><a href=\"https:\/\/raw.githubusercontent.com\/radio24\/TorBox\/master\/install\/run_install_on_ubuntu.sh\">run_install_on_ubuntu.sh<\/a><br>(installation script for Ubuntu-based systems)<\/td><td>\u2794 see Footnotes 3<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>To install TorBox on another system or hardware, download the OS image and transfer it to an SD Card. Under Debian and DietPi, log in to your server as <code>root<\/code>. With Ubuntu, log in to your server as a user (for example, <code>ubuntu<\/code> or <code>torbox<\/code>). Then download and start the installation script:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: bash; title: ; notranslate\" title=\"\">\ncd \nwget https:\/\/raw.githubusercontent.com\/radio24\/TorBox\/master\/install\/&lt;script&gt;\nchmod a+x &lt;script&gt;\n.\/&lt;script&gt;\n<\/pre><\/div>\n\n\n<div style=\"height:46px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>The installation script supports the following options:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\nSyntax : \nrun_install_on_debian.sh &#x5B;-h|--help] &#x5B;--randomize_hostname] &#x5B;--select-tor] &#x5B;--select-fork fork_owner_name] &#x5B;--select-branch branch_name] &#x5B;--on_a_cloud] &#x5B;--torbox_mini] &#x5B;--continue_with_step n] &#x5B;--step_by_step]\nrun_install_on_ubuntu.sh &#x5B;-h|--help] &#x5B;--randomize_hostname] &#x5B;--select-tor] &#x5B;--select-fork fork_owner_name] &#x5B;--select-branch branch_name] &#x5B;--on_a_cloud] &#x5B;--continue_with_step n] &#x5B;--step_by_step]\n\nOptions: -h, --help     : Shows this help screen ;-)\n         --randomize_hostname\n                        : Randomizes the hostname to prevent ISPs to see the default\n         --select-tor   : Let select a specific tor version (default: newest stable version)\n         --select-fork fork_owner_name\n\t\t\t            : Let select a specific fork from a GitHub user (fork_owner_name)\n         --select-branch branch_name\n                        : Let select a specific TorBox branch (default: master)\n         --on_a_cloud   : Installing on a cloud or as a cloud service\n         --torbox_mini  : Installing TorBox mini on a Raspberry Pi Zero 2 W (only with run_install_on_debian.sh)\n         --step_by_step : Executes the installation step by step\n         --continue_with_step n\n                        : Continue the installation with a certain step\n<\/pre><\/div>\n\n\n<div style=\"height:60px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Restart the system. After 2-3 minutes, when the green LED stops flickering, connect your client to the new WiFi network &#8220;TorBox055&#8221; (password:\u00a0<strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>Login to the TorBox by using a&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=112#which-ssh-client-do-you-prefer\" target=\"_blank\" rel=\"noreferrer noopener\">SSH client<\/a>&nbsp;(<strong>192.168.42.1<\/strong>&nbsp;on a WiFi client,&nbsp;<strong>192.168.43.1<\/strong>&nbsp;on a cable client or&nbsp;<strong>192.168.44.1<\/strong>&nbsp;when connected via VPN or if you use&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=3544\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox mini<\/a>&nbsp;on a&nbsp;<a href=\"https:\/\/www.raspberrypi.com\/products\/raspberry-pi-zero-2-w\/\" target=\"_blank\" rel=\"noreferrer noopener\">Raspberry Pi Zero 2 W<\/a>&nbsp;as a RNDIS\/Ethernet Gadget) or a web browser (<a href=\"http:\/\/192.168.42.1\">http:\/\/192.168.42.1 <\/a> on a WiFi client,&nbsp;<a href=\"http:\/\/192.168.43.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/192.168.43.1<\/a>&nbsp;on a cable client or&nbsp;<a href=\"http:\/\/192.168.44.1\/\" target=\"_blank\" rel=\"noreferrer noopener\">192.168.44.1<\/a>&nbsp;when connected via VPN or using TorBox mini; username:&nbsp;<strong>torbox<\/strong>&nbsp;\/ and your chosen password (if no login\/pasword was asked, try <strong>torbox<\/strong>\/ <strong>CHANGE-IT<\/strong>).<\/li>\n\n\n\n<li>After <a href=\"https:\/\/www.torbox.ch\/?page_id=2637\">seeing a welcome screen and answering some initial questions during the first start-up<\/a>, you should see the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=775\" target=\"_blank\" rel=\"noreferrer noopener\">TorBox Main Menu<\/a>. Immediately, you should&nbsp;<strong>change the default passwords<\/strong>&nbsp;(the associated entries are placed in the&nbsp;<a href=\"https:\/\/www.torbox.ch\/?page_id=875\" target=\"_blank\" rel=\"noreferrer noopener\">configuration sub-menu<\/a>.<\/li>\n<\/ul>\n\n\n\n<h6 class=\"wp-block-heading\" id=\"footnotes\"><strong>Footnotes to Remarks &amp; Restrictions<\/strong><\/h6>\n\n\n\n<p><strong>Footnotes 1 regarding Debian 13 (Trixie):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Log in to the freshly prepared Debian system using <code>root<\/code>.<\/li>\n\n\n\n<li>Before you can use <code>wget<\/code>, you have to prepare the Debian system:<br>.\n<ul class=\"wp-block-list\">\n<li>Ensure you are connected to the Internet (see <a href=\"https:\/\/www.torbox.ch\/?page_id=1168#addendum001\">Addendum: How to connect to a wireless network from the CLI?<\/a>).<\/li>\n\n\n\n<li>Set the correct date and time (<a rel=\"noreferrer noopener\" href=\"https:\/\/time.is\/UTC\" target=\"_blank\">UTC<\/a>) with <code>date -s \"YYYY-MM-DDHH:MM\"<\/code><\/li>\n\n\n\n<li>Update the system with <code>apt-get -y update<\/code><\/li>\n\n\n\n<li>Install wget with <code>apt-get -y install wget<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>After installing TorBox and booting the fresh Debian 13 (Trixie) system,&nbsp;<strong>you may need to wait&nbsp;<\/strong>one or two minutes before you can log in.<\/li>\n\n\n\n<li>Debian on a Raspberry Pi may have more problems with wireless adapters and their drivers than the Raspberry Pi OS.<\/li>\n<\/ul>\n\n\n\n<p><strong>Footnotes 2 regarding DietPi 9.20 based on Debian 13 (Trixie):<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Log in to the freshly prepared DietPi system using <code>root<\/code> and as a password <code>dietpi<\/code>.<\/li>\n\n\n\n<li>At the end of the DietPi configuration tool called &#8220;DietPi-Software&#8221;, which runs on a freshly installed DietPi system, change the SSH server from <code>Dropbear<\/code> to <code>OpenSSH Server<\/code> and use <code>Install Software<\/code>.<\/li>\n\n\n\n<li>A TorBox on a DietPi system requires about two-thirds of the space of a TorBox on a Raspberry Pi system.<\/li>\n<\/ul>\n\n\n\n<p><strong>Footnotes 3 regarding Ubuntu 24.04 LTS:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Log in to the freshly prepared Ubuntu system as a user (for example, <code>ubuntu<\/code> or <code>torbox<\/code>).<\/li>\n\n\n\n<li>Ubuntu&#8217;s image file and also the space used by the system after the installation take about 30% more space than Debian or Raspberry Pi OS.<\/li>\n\n\n\n<li>After starting a freshly installed system, <strong>you might wait <\/strong>one or two minutes before logging in with the username &#8220;ubuntu&#8221; and the password &#8220;ubuntu&#8221;.<\/li>\n\n\n\n<li>Ubuntu&#8217;s support for network drivers appears to be better than that of Debian or Raspberry Pi OS. However, due to the unpredictability of Predictable Network Interface Names, we may need to disable that feature before we can connect to a network. You can do that with the following command: <code>sudo ln -s \/dev\/null \/etc\/udev\/rules.d\/80-net-setup-link.rules<\/code> and restart the system.<\/li>\n\n\n\n<li>Especially at the beginning, after a freshly installed TorBox, sometimes, the user is asked to type in his password.<\/li>\n\n\n\n<li>Sometimes, Ubuntu has compatibility issues with SSH terminals.<\/li>\n<\/ul>\n\n\n\n<h1><p style=\"text-align: center;\">\u2022 \u2022 \u2022<\/p><\/h1>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"scratch\">Installation from scratch on a Raspberry Pi with Raspberry Pi OS Lite<\/h5>\n\n\n\n<p>This is probably the safest, but also the most complex and time-consuming method for installing TorBox. Technically, it doesn&#8217;t differ from the installation using the installation script\u2014the only difference is that you write the required configuration files by hand.<\/p>\n\n\n\n<p>For more information, go to <a href=\"https:\/\/www.torbox.ch\/?page_id=205\">our detailed manual<\/a>.<\/p>\n\n\n\n<h1><p style=\"text-align: center;\">\u2022 \u2022 \u2022<\/p><\/h1>\n\n\n\n<h5 class=\"wp-block-heading\" id=\"addendum001\">Addendum: How to Connect to a Wireless Network from the Command-Line Interface (CLI)?<\/h5>\n\n\n\n<p>The easiest and most reliable way to install TorBox using an installation script is to connect the Raspberry Pi to an Ethernet network. Using the onboard wireless chip is a bit more complicated, mainly because we don&#8217;t want to install and start a Graphical User Interface. Since not everyone has the correct procedure in mind for connecting a wireless network via the CLI, we will guide you through it.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>We assume that you logged in as <code>root<\/code>. If this is not the case, you may use <code>sudo<\/code> in front of the commands.<\/li>\n\n\n\n<li>Unblock the wireless interfaces with <code>rfkill unblock wlan<\/code>.<\/li>\n\n\n\n<li>Stop an already running <code>wpa_supplicant<\/code> with <code>systemctl stop wpa_supplicant<\/code>.<\/li>\n\n\n\n<li>Stop NetworkManager: <code>sudo systemctl stop NetworkManager<\/code><\/li>\n\n\n\n<li>Prepare the wireless interface: <code>ip link set dev wlan0 up<\/code><\/li>\n\n\n\n<li>Find wireless networks and note down the name (SSID): <code>iw wlan0 scan | grep SSID:<\/code><\/li>\n\n\n\n<li>Build the <code>wpa_supplicant.conf<\/code> (<code>&lt;SSID&gt;<\/code> is the name of the wireless network to connect, <code>&lt;wifi-password&gt;<\/code> the password of <code>&lt;SSID&gt;<\/code>): <code>wpa_passphrase &lt;SSID&gt; &lt;wifi-password&gt; | tee -a \/etc\/wpa_supplicant\/wpa_supplicant.conf<\/code><\/li>\n\n\n\n<li>Connect to the wireless network: <code>wpa_supplicant -B -c \/etc\/<code>wpa_supplicant\/<\/code>wpa_supplicant.conf -i wlan0<\/code><\/li>\n\n\n\n<li>Start dhclient to get an IP: <code>dhclient wlan0<\/code><\/li>\n<\/ul>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>There are three different ways to install TorBox on a Raspberry Pi 3&nbsp;Model B+, a&nbsp;Raspberry Pi 4 Model B or a Raspberry Pi 5: There are additional installation scripts for other systems, which may also run on different hardware platforms. However, TorBox&#8217;s implementation on other systems and hardware is experimental because we lack the resources &hellip; <a href=\"https:\/\/www.torbox.ch\/?page_id=1168\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Installation &#8211; TorBox&#8221;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","footnotes":""},"class_list":["post-1168","page","type-page","status-publish","hentry"],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"post-thumbnail":false},"uagb_author_info":{"display_name":"radio_24","author_link":"https:\/\/www.torbox.ch\/?author=1"},"uagb_comment_info":0,"uagb_excerpt":"There are three different ways to install TorBox on a Raspberry Pi 3&nbsp;Model B+, a&nbsp;Raspberry Pi 4 Model B or a Raspberry Pi 5: There are additional installation scripts for other systems, which may also run on different hardware platforms. However, TorBox&#8217;s implementation on other systems and hardware is experimental because we lack the resources&hellip;","_links":{"self":[{"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/pages\/1168","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.torbox.ch\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1168"}],"version-history":[{"count":173,"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/pages\/1168\/revisions"}],"predecessor-version":[{"id":4074,"href":"https:\/\/www.torbox.ch\/index.php?rest_route=\/wp\/v2\/pages\/1168\/revisions\/4074"}],"wp:attachment":[{"href":"https:\/\/www.torbox.ch\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1168"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}