Frequently Asked Questions

Frequently asked questions regarding LunaSea

How Do I Install a "Module"?

The software, or as I use in LunaSea "Modules", are all pieces of software that must be installed on a home computer or server. None of the currently supported software has been developed by myself, so the amount of support I can offer for each module has limitations. LunaSea does not itself have the functionality of that software, it acts as a remote.

Who Makes LunaSea?

Only one person, me! Hi, my name is Jagandeep Brar, and I am a software engineer from Canada. I am currently the main and only developer on LunaSea, but I encourage anyone who is interested and wants to contribute to the project to make a pull request on GitHub!

What is LunaSea Developed In?

LunaSea is developed using Google's hybrid framework, Flutter, which uses Dart as its core language. Using Flutter allows an indie developer like myself to build cross-platform applications more easily, as it is one single codebase that allows me to build across both mobile platforms, and in the future the potential of a web interface and desktop applications!

How is LunaSea Free?

LunaSea started off as (and still is) a passion project, fuelled by my love for data hoarding and collecting. It was open-sourced soon after it's initial launch to allow LunaSea to get into the hands of as many users as possible, and to give back to the community where there is a lack of open-source, high quality mobile applications.

Are You Ever Going To Charge Money/Insert Ads?


The only possible reason that LunaSea will ever have any kind of payment model is if features are introduced that cost me recurring charges that are too large to bear. Any and all features that do not incur me a charge will be free, and even any features that would cost me money will become open-source, which offers everyone the ability to have a completely free experience in LunaSea.

Can You Support "X" Feature/Module?

I take all requests into consideration! If you would like to request a feature there are a few ways I recommend:

  • (Preferred) Feedback Board: The feedback board allows users to create, comment on, and vote on new features and general requests! This is the ideal way to request a new feature, as it allows other users to see active requests, it allows discussions to stay per-request, and the voting system gives me a good indication on the active demand for a feature.

  • Discord

  • Email

  • Reddit

I may not have the ability to respond to all requests directly, but please be ensured I do read everything!

Why Isn't Feature/Module "X" Supported Yet?

As mentioned earlier, LunaSea is only developed by one person, and while I try to put as much time into LunaSea as I can, I still do have a family, a career, and I want to enjoy my personal time.

I also want to point out that I don't want to make LunaSea a wide ranging, but no depth application. I want every application to have as full of an implementation as possible, which can mean that new modules will take time to get implemented between one another.

I Found a Bug! How Do I Let You Know?

I tried to make it as stable as possible, but bugs obviously will always be there (when you fix a bug, you make 5 more...). If you do run into a bug (especially a fatal/crashing bug), please also attach the logs from the application into the report. Logs can be exported from the settings as a text file.

  • (Preferred) GitHub Issues: The best place to alert me of new issues is directly on the GitHub page. Please try to follow the template for bug reports, but again I am not overly strict and a good explanation of the issue will suffice (this may change in the future if it gets increasingly hard to manage).

  • Discord

  • Email

  • Reddit

Why Don't The Settings Explain Much?

I understand that the settings section could definitely use better documentation and linking, but this ambiguity and sparse documentation directly within LunaSea is by design.

LunaSea took quite a runaround to initially get on the App Store because of its relationship with how you acquire Linux ISOs. After successfully getting it on the App Store, I want to avoid adding anything to LunaSea that would potentially get it revoked.

"X" Won't Connect, Help!

The initial setup can either be incredibly easy or make you want to pull your hair out, I get that and that's what the community is here for! Please feel free to send a message to any of the above listed methods to get support where either I or an awesome user in the community will surely come to help you out.

A few quick tips on common problems:

  • localhost and are internal hostnames that means "this computer". They cannot and should not be used as the host, but is commonly used because users mainly access the service from the computer running it. In order for LunaSea to connect, you must find the local IP of your computer (most common home networking configurations have it start with 192.168.0.x or 192.168.1.x)

  • Ensure you match the right API key to the right service. I know this seems like an obvious thing, but you'd be surprised how easy it is to mix up 3-4 API keys when you're going back and forth copying and pasting!

  • For the -rr services, ensure the binding address in the advanced general settings is not set to or localhost, but instead set to either, *, or the local IP for the computer/server.

  • Similarly for the clients, ensure that the host is set to, or the local IP.

  • As noted in the host prompt, you must add either http:// or https:// before the IP or domain. LunaSea does not make any assumptions on the protocol to use (http or https).

  • Do not use 3xx redirecting webpages. This is not supported for POST and PUT requests (sending data back to the module) and can cause many headaches, so ideally you should be pointing directly to the module on your network.

How Can I Access My Services Remotely?

While this is outside of the scope of this project, I can try to point you in the right direction!

  • Reverse Proxy: A reverse proxy allows you to open 1 or 2 ports on your network (typically 443 for SSL/https connections and 80 for http connections). Using a reverse proxy also allows you to attach a domain name to your IP and generate a free SSL certificate for https (hint, LetsEncrypt). Some common options for reverse proxies are NGINX Proxy Manager, Traefik, NGINX, and Apache.

  • VPN Tunnelling: Another option is to create a VPN tunnel back to your home network, which would allow you to access your services as if you are on your home network. Tools like WireGuard and OpenVPN are perfect for this use case. This is technically the most secure method, but a bit less convenient than using a reverse proxy.

  • (NOT RECOMMENDED) Direct Port Forwarding: Another option is directly forward the ports of the services on your router and access the services via <External IP>:<Port>. The reason this is not recommend is because all of the traffic is sent unencrypted (you can use self-signed certificates, but this causes more headaches related to certificate authorities), and the more ports that are open on your network the less secure it is.

I Want to Complain! Where Can I Complain?

Sorry that LunaSea is not meeting your expectations, feel free to post criticisms or complaints to any of the social platforms or directly email me. I hope that I can remedy your complaints, all I ask is that you do not be abusive or disrespectful to myself or others in the community.

I also kindly request that before you submit a 1-star App Store/Play Store review that you consider contacting me directly with your complaints. 1-star reviews can really hurt a smaller applications reviews since we do not typically get lots of reviews.

How Do I Join the Beta?

  • TestFlight (iOS): For iOS we must use Apple's TestFlight program, which requires you to download the TestFlight application to your device and click the link to join the beta. Please note that in-app purchases are not actually charged while running TestFlight releases, so if you want to donate within the application you must re-download the application from the App Store.

  • Play Store (Android): On the Play Store page there should be an option to join the beta directly! From thereon out you will get beta releases.