User Tools

Site Tools


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
en:cube:install [2021/08/15 14:06] hgoen: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://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME2/open-source-hardware) or [lime](https://www.olimex.com/Products/OLinuXino/A20/A20-OLinuXino-LIME/)) and configure it with the Neutrinet VPN.
  
 ## Generate the VPN certificates ## Generate the VPN certificates
  
-In order to use our VPN, you need to follow [this registration process](en:vpn:order). You will generate a private key and obtain a personal VPN certificate.+In order to use our VPN, you need to follow [this registration process](en:vpn:vpn-order). You will generate a private key and obtain a personal VPN certificate.
  
 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.
Line 202: Line 202:
 ## Troubleshootings ## Troubleshootings
  
-### 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/) 
- 
-You can disable this by running the following: 
-```bash 
-sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-zram-config -i 
-sudo sed 's/^tmpfs/# tmpfs/' /etc/fstab -i 
-``` 
 If you have issues, or maybe you were able to find a fix for an issue, do not hesitate to contact us : https://chat.neutrinet.be If you have issues, or maybe you were able to find a fix for an issue, do not hesitate to contact us : https://chat.neutrinet.be
  
-### Debian repositories changed from stable to oldstable+### During the install 
 + 
 +#### Debian repositories changed from stable to oldstable
  
 See also https://github.com/YunoHost/issues/issues/1852 See also https://github.com/YunoHost/issues/issues/1852
Line 237: Line 230:
 And then answer yes to the questions. And then answer yes to the questions.
  
-### VPN install failed+#### VPN install failed
  
 See also https://github.com/labriqueinternet/install/issues/4 See also https://github.com/labriqueinternet/install/issues/4
Line 262: Line 255:
 Then, run the command that failed: Then, run the command that failed:
 ```bash ```bash
-sudo ynh-vpnclient-loadcubefile.sh -u "$(head -n 1 /etc/openvpn/keys/credentials)" -p "$(tail -n 1 /etc/openvpn/keys/credentials)" -c /tmp/config.cube+sudo ynh-vpnclient-loadcubefile.sh -u "<username>" -p "<password>" -c /tmp/config.cube
 ``` ```
 +(Please replace `<username>` and `<password>` with your credentials.)
 +
 +:!: Make sure to keep the quotes!
  
 On the internet cube installer, retry the last step by clicking on the yellow button. 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/nftables doesn't seem to be working
 +
 +See https://chat.neutrinet.be/api/v4/files/3wxxx14t7fg6xjomitpyojk4fy/preview
 +
 +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://forum.armbian.com/topic/10977-tmp-gets-eventually-full-how-to-purge-it/)
 +
 +You can disable this by running the following:
 +```bash
 +sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-zram-config -i
 +sudo sed s/^ENABLED=true/ENABLED=false/ /etc/default/armbian-ramlog -i
 +sudo sed 's/^tmpfs/# tmpfs/' /etc/fstab -i
 +```
 +
 +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 you are able to ping them. In addition, if you have a domain in .nohost.me or .nohost.fr, etc. your cube won't be able to update the DynDNS. 
 +
 +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/client.conf.tpl
 +```
 +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 /etc/fstab
 +```
 +
 +Add the line :
 +```bash
 +/swapfile none swap sw 0 0
 +```
 +
en/cube/install.1629029211.txt.gz · Last modified: 2021/08/15 14:06 by hgo