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/15 00:09] – 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 102: | Line 102: | ||
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=/ | ||
``` | ``` | ||
- | FIXME Ensure that the SD card is *not* mounted during the copy process! | + | :!: 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 202: | Line 202: | ||
## 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 209: | 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.1628978998.txt.gz · Last modified: 2021/08/15 00:09 by hgo