💾Self hosting Inuva
You can now host Inuva yourself. You can transform any headless server to a "head full(?)" server with Inuva. Enjoy all of the benefits from Inuva without the pesky subscriptions.
How can I install it?
When you buy the Inuva standalone version, you get a license key. The license key is 11 characters long and is valid for up to 5 machines. You don't have to note down the license key as you can retrieve it anytime you want on the Inuva site.
Once you log in you'll be redirected to the download page. The command to download the installer will be displayed along with your license key.
You can enter these commands in any Linux distribution (tested on Ubuntu 22 and Debian). This will load up the installer and prompt you to configure your unique Inuva configuration. During the installation process, you'll be prompted to enter a 6 digit passcode, this will be your login password.
Once the installer is finished you will have the following:
The Inuva server running on port
49152A new entry in crontab that automatically updates Inuva
Optionally: Nginx configured with Brotli module and HTTP/3
Optionally: VS Code dev tunnel installed on the system
Inuva will be installed in /srv/inuva. Here you'll find the SQLite database and the compiled code.
What now?
The inuva server is running on port 49152 if the server is on your local network you can surf to the machine's IP-address with the port number like this http://192.0.0.3:49152. You'll see the login screen and you can now enter the 6 digit passcode that you entered during installation.
After 10 failed login attempts you will be blocked for 15 minutes. This protects you from attackers that try to brute force your login.
After a succesful login, you'll be redirected to the desktop page. That should look a bit like this:
Public Access
If you have followed this guide, you are accessing Inuva on your local network. When you're on the go you don't have access to your local network but you probably still want to access your Inuva desktop.
It is strongly advised to only access Inuva over secure TLS connections!
If you're new to hosting a public website on a server I would strongly recommend that you look into Nginx that acts as a reverse proxy. For more advanced users, you can download an Nginx template from the inuva website by making an authenticated GET request to https://inuva.me/api/configs/nginx/user/tls . You can learn how to make authenticated requests at API
Next steps
Congratulations, you have Inuva installed on your machine or server. You can now access your machine or server with a GUI from anywhere on any devices. Make sure to test out Inuva on your smartphone or tablet.
You can join the Discord for the latest updates, report bugs, request new features and vote on major updates.
Troubleshooting
I see errors during installation
This can happen, the installer tries to recover from failed installations but you can check a couple of things.
Try to install again with
--force, without extra options such as Nginx, VS Code, auto updates. If this succeeds, you can restart the installer with modules enabled until you find which module is causing the error.Check if the Inuva server is running by entering the following command
sudo systemctl status inuva. If this is running you should be able to navigate to your desktop.Check if the cron entry was made by executing the following command
sudo cat /etc/crontab. If you don't see any entry with Inuva, you can contact us or wait for a new update.Nginx install fails, this is highly experimental and only works on Ubuntu 22. Any other installation is not tested or patched.
You can find logs in various places:
/var/log/inuva.log,/var/log/update.log,sudo systemctl status inuva,sudo journalctl -u inuvaNode is not installed or you don't have the correct version installed. I would highly recommend installing NVM:
If something just isn't working out, feel free to post it on the Discord or just DM me. I'm also available on Twitter! If you like a more traditional way to reach out, you can contact support@inuva.me.
Last updated
