User Tools

Site Tools

Trace:
en:cube:install

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
en:cube:install [2021/06/17 12:28] – [Run the Yunohost postinstall] celoen:cube:install [2021/08/15 00:09] – hgo
Line 9: Line 9:
 In case, for some reason, you are reinstalling a cube and you want to reuse your VPN certificate, you can find them on a running (or dead) cube as user.crt, user.key, ca-server.crt and credentials in /etc/openvpn/keys. In case, for some reason, you are reinstalling a cube and you want to reuse your VPN certificate, you can find them on a running (or dead) cube as user.crt, user.key, ca-server.crt and credentials in /etc/openvpn/keys.
  
-##Generate a cube file+## Generate a cube file
  
 To configure Yunohost's VPN app, you will need a cube file which contains your VPN credentials and certificates. Put all the VPN files in the same folder.  To configure Yunohost's VPN app, you will need a cube file which contains your VPN credentials and certificates. Put all the VPN files in the same folder. 
Line 35: Line 35:
 ./faire_un_point_cube.sh  ./faire_un_point_cube.sh 
 ``` ```
- 
- 
  
  
Line 63: Line 61:
 ### Download the Yunohost image ### Download the Yunohost image
  
-Download the latest version of Yunohost for internet cubes (Olimex Lime1 or Lime2) from https://yunohost.org/fr/install/hardware:internetcube+Download the latest version of Yunohost for internet cubes (Olimex Lime1 or Lime2) from [[https://yunohost.org/en/administrate/install/hardware:internetcube]]
  
-For instance, for a Lime1:+For instance, for a Lime2 board:
 ```bash ```bash
-wget https://github.com/YunoHost/arm-images/releases/download/v2021.02/internetcube_4.1.7.1_v2021.02_lime.img.gz+wget https://build.yunohost.org/internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz 
 +``` 
 + 
 +Import the Yunohost GPG key: 
 +```bash 
 +gpg --keyserver keyserver.ubuntu.com --recv-keys 1904C5B42E4856DCD4E9CF96360AAF3259A3E6FF 
 +``` 
 + 
 +Download the image's signature: 
 +```bash 
 +wget https://build.yunohost.org/internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz.sig 
 +``` 
 + 
 +Verify the image's signature: 
 +```bash 
 +gpg --verify internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz.sig
 ``` ```
  
 Uncompress the Yunohost image: Uncompress the Yunohost image:
 ```bash ```bash
-gunzip internetcube_4.1.7.1_v2021.02_lime.img.gz+gunzip internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img.gz
 ``` ```
  
 ### Flash the SD card ### Flash the SD card
 +
 +Read the Yunohost documentation for graphical methods: [[https://yunohost.org/en/administrate/install/hardware:internetcube#flash-the-image-type-image]]
  
 First, find the device name of your SD card: First, find the device name of your SD card:
Line 85: Line 100:
 Install the image on your SD card (all data on the SD card will be lost). Install the image on your SD card (all data on the SD card will be lost).
 ```bash ```bash
-sudo dd if=internetcube_4.1.7.1_v2021.02_lime.img of=/dev/mmcblk0 status=progress+sudo dd if=internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img of=/dev/mmcblk0 status=progress
 ``` ```
 +FIXME Ensure that the SD card is *not* mounted during the copy process!
  
 Remove the SD card from your computer when it's done. Remove the SD card from your computer when it's done.
Line 111: Line 127:
 In your terminal, run: In your terminal, run:
 ```bash ```bash
-./install-sd.sh -l+for interface in $(ip link show up | grep "state UP" | cut -d ':' -f 2); do 
 +  sudo arp-scan -l --interface "$interface" | grep -P '\t02' | cut -f 1 
 +done
 ``` ```
  
-The script can be download here : [[https://github.com/labriqueinternet/install.labriqueinter.net/blob/master/install-sd.sh]] +The output should give you a list of IP addresses:
- +
-The output should look like this:+
 ``` ```
-Internet Cubes found on the network: +192.168.1.46
- +
-  1. YunoHost Admin:    https://192.168.1.46 +
-     SSH Access:        ssh root@192.168.1.46 +
-     HyperCube Debug:   http://192.168.1.46:2468/install.html+
 ``` ```
  
-In this example, the IP address of your Cube on the local network is: +These are IP addresses of Internet Cubes connected on the local network.
-192.168.1.46+
  
-If the script cannot find your cube, try again a couple of minutes later.+If you cannot find your cube, try again a couple of minutes later.
  
-## Run the Yunohost postinstall+## Run the Internet Cube installer
  
 Connect to https://192.168.1.46 Connect to https://192.168.1.46
-(Please replace 192.168.1.46 with the IP address of your Cube found in the previous step)+(Please replace `192.168.1.46` with the IP address of your Cube found in the previous step)
  
-Start the Yunohost postinstall and provide:+Provide the following details:
   * The main domain name   * The main domain name
-  * The admin password +  * First user name 
-You will be able to change the admin password later on if you want.+  * First user password (this will be your admin password as well) 
 +  * Your cube file generated in a previous step 
 +  * Your Wifi hotspot credentials (optional)
  
-### Create the first user+You will be able to change your passwords later on if you want.
  
-In the admin panel, go to Users and create the first user by providing: +### Install the Neutrinet app
-- username +
-- firstname +
-- lastname +
-- password +
-This user is a bit special because it will be linked to the root@domain.tld mail address.+
  
-### Install the VPN client+Your VPN certificate will be valid for 1 year.
  
-In the admin panel, go to Applications and click on the Install button. +Connect to your Cube with SSH:
- +
-Search for `VPN Client` app, then install it. +
- +
-Copy the .cube file you generated earlier. From your machine, run:+
 ```bash ```bash
-scp neutrinet.cube admin@192.168.1.46:/tmp/neutrinet.cube+ssh admin@192.168.1.46
 ``` ```
 (Please replace 192.168.1.46 with the IP address of your Cube found in the previous step) (Please replace 192.168.1.46 with the IP address of your Cube found in the previous step)
-The admin password of your Cube is the same as the one for the admin panel. 
  
-Connect to your Cube via SSH as admin: 
-```bash 
-ssh admin@192.168.1.46 
-``` 
- 
-Configure the VPN client: 
-```bash 
-ynh-vpnclient-loadcubefile.sh -u raoul -c /tmp/neutrinet.cube -p neutrinet 
-``` 
-(Please replace raoul and neutrinet with the username and password of the first user) 
- 
-Check that your cube is connected to the VPN: 
-- Run `ip a` from the cube and check if there is a `tun0` interface 
-- Connect to the IP in your web browser 
- 
-### Install the Neutrinet app 
- 
-Your VPN certificate will be valid for 1 year. 
  
 Install the Neutrinet app for Yunohost in order to let the cube automatically renew the certificate before expiration: Install the Neutrinet app for Yunohost in order to let the cube automatically renew the certificate before expiration:
Line 190: Line 175:
  
 See [this page](dns). See [this page](dns).
 +
 +## Configure IPv6 for the Hotspot Wifi
 +
 +If you installed the hotspot Wifi, you need an extra step to configure IPv6.
 +
 +Connect to https://user.neutrinet.be/ and enter your VPN credentials. You can find them in your cube file or in `/etc/openvpn/keys/credentials` on your internet cube.
 +
 +Go to your client details by clicking on the entry with mail address.
 +
 +You should see IPv6 subnet lease (the row with a `/64` IPv6). 
 +
 +In case you don't have a IPv6 subnet lease yet, click on `Modify IP lease assignment`.
 +
 +Then click on your mail address and click `Add IPv6 subnet lease`.
 +
 +Choose a range of 64, and click on the `Assign` button.
 +
 +You can then go back to the home page to see your new IPv6 subnet lease.
 +
 +Connect to Wifi Hotspot admin of your internet cube: https://192.168.1.46/wifiadmin/
 +
 +Then, under the tab `IPv6`, paste the IPv6 subnet lease to the delegated prefix field. 
 +
 +Click on the button `Save and reload` to apply your changes.
  
 ## Troubleshootings ## Troubleshootings
  
-### Issues with `/tmp` in RAM+### Issues with /tmp in RAM
  
 By default, the files `/tmp` folder are stored in RAM, which isn't a good idea when you have less than 1Gb available in a cube. See [tmpfs / armbian](https://forum.armbian.com/topic/10977-tmp-gets-eventually-full-how-to-purge-it/) By default, the files `/tmp` folder are stored in RAM, which isn't a good idea when you have less than 1Gb available in a cube. See [tmpfs / armbian](https://forum.armbian.com/topic/10977-tmp-gets-eventually-full-how-to-purge-it/)
en/cube/install.txt · Last modified: 2022/09/16 13:07 by celo