Host setup for local development #532

Open
opened 2026-02-16 12:35:49 -05:00 by yindo · 2 comments
Owner

Originally created by @ivanlori on GitHub (Feb 15, 2026).

What happened?

Hi.
While trying to setup my local environment I read on the README file that the application will be available at the current url -> http://local.revolt.chat:5173
clicking it I get this page:

Image

I solved by updating the vite.config.ts with the following code:


server: {
    allowedHosts: ["local.revolt.chat"],
  },

at this point my question is: why this code wasn't there already? Is my setup wrong in some way?

Thanks!

Originally created by @ivanlori on GitHub (Feb 15, 2026). ### What happened? Hi. While trying to setup my local environment I read on the README file that the application will be available at the current url -> http://local.revolt.chat:5173 clicking it I get this page: <img width="777" height="80" alt="Image" src="https://github.com/user-attachments/assets/3c991b06-63f6-4bc0-b06d-155a7083c39a" /> I solved by updating the `vite.config.ts` with the following code: ``` server: { allowedHosts: ["local.revolt.chat"], }, ``` at this point my question is: why this code wasn't there already? Is my setup wrong in some way? Thanks!
Author
Owner

@TonyKuroi commented on GitHub (Feb 15, 2026):

Frankly, the project is still young, and has a lot of similar tiny issues. I've been messing around with it today and in the space of four hours I've found several instances where the documentation is incorrect/outdated, or certain configurations need to be changed.

Interestingly, local.revolt.chat is just set up to resolve to 127.0.0.1, which if I'm being frank is a stupid way to handle a localhost dev environment. But, consequently, the app works just the same if you navigate to http://localhost:5173, which is what vite shows when you start it. Technically, this would be more "reliable," as then it can resolve if the machine you're working on for some reason doesn't have internet.

Anyways, no, your setup isn't incorrect, the documentation is. I'm sure they'll fix it with time.

@TonyKuroi commented on GitHub (Feb 15, 2026): Frankly, the project is still young, and has a lot of similar tiny issues. I've been messing around with it today and in the space of four hours I've found several instances where the documentation is incorrect/outdated, or certain configurations need to be changed. Interestingly, local.revolt.chat is just set up to resolve to 127.0.0.1, which if I'm being frank is a stupid way to handle a localhost dev environment. But, consequently, the app works just the same if you navigate to http://localhost:5173, which is what vite shows when you start it. Technically, this would be more "reliable," as then it can resolve if the machine you're working on for some reason doesn't have internet. Anyways, no, your setup isn't incorrect, the documentation is. I'm sure they'll fix it with time.
Author
Owner

@Zomatree commented on GitHub (Feb 15, 2026):

The local. domain is mainly for hcaptcha to work on local dev environments, it's not required.

@Zomatree commented on GitHub (Feb 15, 2026): The local. domain is mainly for hcaptcha to work on local dev environments, it's not required.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: stoatchat/for-web#532