do you have any basic setup instructions (OS already installed) for setting up a standalone server and what the requirements are?

and at this point I thought that I may as well put this in a VM on a internal company server.

What VM are you planning on using? Can you use a Linux distro or need to use something specific like a Microsoft OS?

Since it's Ruby code it should work fine as long as the Ruby runtime is available. If you're comfortable with and also able to use Linux let me know and I can share with you an easy to use (almost "packaged") Docker image to run. Just FYI Ruby images aren't known for being lightweight, but I think it shouldn't be too bad and it's an easy way to run it and have the Docker daemon handle the restarts, errors, logging, etc.

If you're not into the Docker option then I'd recommend something along the lines of:

1. Installing Ruby 3.1.2
   • Using RVM (recommended) or any other version manager
   • Directly on OS the "manual way"
2. Fork the repo and clone your fork on that VM
3. From the repo directory install dependencies with bundle install
4. Run bundle exec puma -p 4567 to ensure it runs (customize the port if you want)
5. Find a way to handle VM restarts/failures/etc for your OS

(we can't view links in outlook that starts with ms-mobile-apps:/// for some stupid reason)

I guess the other thing I should ask, I guess it would be easy for me to edit the source code so that I can use the ms-mobile-apps:/// protocol instead of https?

I may or may not be understanding the use case exactly right, but I think what you want work with is changing the schema handled by the server.rb. Something along the lines of what I did on #22. You can checkout and test that branch to see if it works for you once you have the server up and running.

That PR was just a very quick and dirty experiment so I'm a bit skeptical of whether it will work. Let me know if it does so I can implement a more permanent solution to support these in the codebase. Otherwise talk me through the situation you want to achieve a bit more in detail to see if I can help. Perhaps something like:

I want to have users go into the URL ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId> from an Outlook email so I want to have the browser redirect me to XXXXXXX for deep linking

I'm using Rocky Linux (https://rockylinux.org/), from what I understand is like CentOS (the free version of RedHat).

I managed to get things up and running (I went the manual route as I have no experience with docker), just had to fight with versions (I had ruby 3.1.2 for example) and open up the firewall a little. Other than that, in my quick testing, things are working as expected.

As to what I'm waiting to do, you pretty much got it. Since outlook doesn't support linking to ms-mobile-apps:// protocol properly, I thought that I could use UDL as a mini proxy where I could just link people to something like https://r.domain.com/?r=ms-mobile-apps://xxxxxx and then the browser would do the direction for me.

I managed to get things up and running (I went the manual route as I have no experience with docker), just had to fight with versions (I had ruby 3.1.2 for example) and open up the firewall a little. Other than that, in my quick testing, things are working as expected.

That's great to hear 👍🏼

As to what I'm waiting to do, you pretty much got it. Since outlook doesn't support linking to ms-mobile-apps:// protocol properly, I thought that I could use UDL as a mini proxy where I could just link people to something like https://r.domain.com/?r=ms-mobile-apps://xxxxxx and then the browser would do the direction for me

Sounds good then. If you can, let me know if what's on main works with that ms-mobile-apps scheme. If it doesn't work pull the latest from branch ms-powerapps (the branch of #22) and then let me know if that does the job. I pushed some quick changes there to better handle these custom scheme redirects.