en:cube:install
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:cube:install [2021/08/14 21:36] – [Issues with `/tmp` in RAM] hgo | en:cube:install [2022/09/16 13:07] (current) – [After the install] celo | ||
---|---|---|---|
Line 1: | Line 1: | ||
# Install a cube | # Install a cube | ||
- | This procedure explains how to setup an Internet Cube and configure it with the Neutrinet VPN. | + | This procedure explains how to setup an Internet Cube (Olimex [Lime2](https:// |
## Generate the VPN certificates | ## Generate the VPN certificates | ||
- | In order to use our VPN, you need to follow [this registration process](en: | + | In order to use our VPN, you need to follow [this registration process](en: |
In case, for some reason, you are reinstalling a cube and you want to reuse your VPN certificate, | In case, for some reason, you are reinstalling a cube and you want to reuse your VPN certificate, | ||
Line 35: | Line 35: | ||
./ | ./ | ||
``` | ``` | ||
- | |||
- | |||
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:// | + | Download the latest version of Yunohost for internet cubes (Olimex Lime1 or Lime2) from [[https:// |
For instance, for a Lime2 board: | For instance, for a Lime2 board: | ||
Line 70: | Line 68: | ||
``` | ``` | ||
- | Download | + | Import |
```bash | ```bash | ||
- | wget https:// | + | gpg --keyserver keyserver.ubuntu.com --recv-keys 1904C5B42E4856DCD4E9CF96360AAF3259A3E6FF |
``` | ``` | ||
- | Import | + | Download |
```bash | ```bash | ||
- | gpg --keyserver keyserver.ubuntu.com --recv-keys 1904C5B42E4856DCD4E9CF96360AAF3259A3E6FF | + | wget https:// |
``` | ``` | ||
Line 92: | Line 90: | ||
### Flash the SD card | ### Flash the SD card | ||
- | Read the Yunohost | + | Read the Yunohost |
First, find the device name of your SD card: | First, find the device name of your SD card: | ||
Line 103: | Line 101: | ||
```bash | ```bash | ||
sudo dd if=internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img of=/ | sudo dd if=internetcube-buster-4.1.7.4_v2021.04.01-lime2-stable.img of=/ | ||
- | sync | ||
``` | ``` | ||
+ | :!: 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 143: | Line 141: | ||
If you 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:// | Connect to https:// | ||
- | (Please replace 192.168.1.46 with the IP address of your Cube found in the previous step) | + | (Please replace |
Provide the following details: | Provide the following details: | ||
* The main domain name | * The main domain name | ||
* First user name | * First user name | ||
- | * First user password (this will be your admin password) | + | * First user password (this will be your admin password |
* Your cube file generated in a previous step | * Your cube file generated in a previous step | ||
- | * Your Wifi hotspot credentials | + | * Your Wifi hotspot credentials |
You will be able to change your passwords later on if you want. | You will be able to change your passwords later on if you want. | ||
Line 177: | 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:// | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | 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 | + | If you have issues, or maybe you were able to find a fix for an issue, do not hesitate to contact us : https:// |
+ | |||
+ | ### During the install | ||
+ | |||
+ | #### Debian repositories changed from stable to oldstable | ||
+ | |||
+ | See also https:// | ||
+ | |||
+ | At the very first step of the internet cube installer, the install is stuck with the following error: | ||
+ | ``` | ||
+ | E: Repository ' | ||
+ | E: Repository ' | ||
+ | E: Repository ' | ||
+ | Command ' | ||
+ | ``` | ||
+ | |||
+ | Connect with SSH to your cube with the root account: | ||
+ | ```bash | ||
+ | ssh root@192.168.1.46 | ||
+ | ``` | ||
+ | Enter `yunohost` as password. | ||
+ | |||
+ | Then, just run: | ||
+ | ```bash | ||
+ | apt update | ||
+ | ``` | ||
+ | And then answer yes to the questions. | ||
+ | |||
+ | #### VPN install failed | ||
+ | |||
+ | See also https:// | ||
+ | |||
+ | In case there are special characters in your VPN account password:, the install will fail with the following error: | ||
+ | ``` | ||
+ | Running: yunohost app addaccess vpnclient -u ' | ||
+ | ' | ||
+ | ' | ||
+ | allowed_users: | ||
+ | vpnclient: ****** | ||
+ | Running: yunohost app setting vpnclient service_enabled -v 1 | ||
+ | Running: ynh-vpnclient-loadcubefile.sh -u ' | ||
+ | [VPN] Error: Configuration updated but service reload failed | ||
+ | Command ' | ||
+ | ``` | ||
+ | |||
+ | Connect to your internet cube with the admin account: | ||
+ | ```bash | ||
+ | ssh admin@192.168.1.46 | ||
+ | ``` | ||
+ | Enter your admin password. | ||
+ | |||
+ | Then, run the command that failed: | ||
+ | ```bash | ||
+ | sudo ynh-vpnclient-loadcubefile.sh -u "< | ||
+ | ``` | ||
+ | (Please replace `< | ||
+ | |||
+ | :!: Make sure to keep the quotes! | ||
+ | |||
+ | On the internet cube installer, retry the last step by clicking on the yellow button. | ||
+ | |||
+ | #### The loading bar freeze | ||
+ | |||
+ | If the loading bar freeze during the install, set the debug mode button to up. | ||
+ | |||
+ | You will then see the details of the install and what the install procedure is doing. | ||
+ | |||
+ | #### iptables/ | ||
+ | |||
+ | See https:// | ||
+ | |||
+ | This is due to a kernel update: you just need to reboot the cube. | ||
+ | |||
+ | Then, connect to the internet cube installer and retry the last step. | ||
+ | |||
+ | ### After the install | ||
+ | |||
+ | #### 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:// | 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:// | ||
Line 187: | Line 286: | ||
```bash | ```bash | ||
sudo sed s/ | sudo sed s/ | ||
+ | sudo sed s/ | ||
sudo sed ' | sudo sed ' | ||
``` | ``` | ||
- | If you have issues, or maybe you were able to find a fix for an issue, do not hesitate | + | |
+ | Then, reboot the cube: | ||
+ | ```bash | ||
+ | sudo reboot | ||
+ | ``` | ||
+ | |||
+ | #### Unable to access some websites from the cube | ||
+ | |||
+ | When your cube is connected to the Neutrinet VPN in IPv6, you might be unable to access some websites, although | ||
+ | |||
+ | Connect with SSH to the cube: | ||
+ | ```bash | ||
+ | ssh admin@192.168.1.46 | ||
+ | ``` | ||
+ | |||
+ | You need to reduce the MTU used to connect to the VPN: | ||
+ | ```bash | ||
+ | sudo nano /etc/openvpn/ | ||
+ | ``` | ||
+ | In the section `neutrinet` or `Custom`, add the line: | ||
+ | ``` | ||
+ | mssfix 1400 | ||
+ | ``` | ||
+ | |||
+ | Then, restart the VPN client: | ||
+ | ```bash | ||
+ | sudo systemctl stop openvpn@client.service | ||
+ | sudo systemctl start ynh-vpnclient-checker | ||
+ | ``` | ||
+ | |||
+ | #### Roundcube fails to install on Lime 1 | ||
+ | |||
+ | Roundcube require more than 500M to install. On lime 1, it's necessary to add swap. You can do it by running the following : | ||
+ | |||
+ | ```bash | ||
+ | sudo fallocate -l 1G /swapfile | ||
+ | sudo chmod 600 /swapfile | ||
+ | sudo mkswap /swapfile | ||
+ | sudo swapon /swapfile | ||
+ | ``` | ||
+ | You can verify that swap is available : | ||
+ | |||
+ | ```bash | ||
+ | sudo swapon --show | ||
+ | ``` | ||
+ | |||
+ | This should return a line about the swap. | ||
+ | |||
+ | Then edit your fstab file to activate the swap on startup : | ||
+ | |||
+ | ```bash | ||
+ | sudo nano / | ||
+ | ``` | ||
+ | |||
+ | Add the line : | ||
+ | ```bash | ||
+ | /swapfile none swap sw 0 0 | ||
+ | ``` |
en/cube/install.1628969769.txt.gz · Last modified: 2021/08/14 21:36 by hgo